Utils API
Utils API küçük yardımcı fonksiyonları barındırır: UUID üretme, tarih, bit işlemleri, sayı formatlama, metin pad.
Benzersiz Kimlik
Section titled “Benzersiz Kimlik”ins.uuid()
Section titled “ins.uuid()”Yeni bir UUID string’i üretir.
var id = ins.uuid();// → "f4cbb047-4376-4d8b-ae46-5cafed31155b"ins.now()
Section titled “ins.now()”Sunucunun güncel zamanını Date olarak döndürür.
var n = ins.now();// → Wed Apr 23 00:15:42 TRT 2026ins.getDate(ms)
Section titled “ins.getDate(ms)”Verilen epoch milisaniyesine karşılık gelen Date’i döndürür.
var yesterday = ins.getDate(Date.now() - 86400000);var oneHourAgo = ins.getDate(Date.now() - 3600000);Bit İşlemleri
Section titled “Bit İşlemleri”ins.getBit(value, bitIndex)
Section titled “ins.getBit(value, bitIndex)”Bir Long değerin belirli bit’ini (0 = en sağdaki) okur — Boolean döner.
var statusWord = ins.getVariableValue("status_register").value;var bit3 = ins.getBit(statusWord, 3); // true | falseins.setBit(value, bitIndex, bitValue)
Section titled “ins.setBit(value, bitIndex, bitValue)”Bir Long değerin belirli bit’ini değiştirir — yeni Long döner (orijinal değer değişmez).
var word = 0;word = ins.setBit(word, 0, true); // bit 0 = 1 → 1word = ins.setBit(word, 3, true); // bit 3 = 1 → 9Metin ve Sayı Formatlama
Section titled “Metin ve Sayı Formatlama”ins.leftPad(str, len, padChar)
Section titled “ins.leftPad(str, len, padChar)”Metnin soluna padChar ekleyerek len uzunluğa tamamlar.
ins.leftPad("42", 5, "0"); // → "00042"ins.leftPad("AB", 4, " "); // → " AB"ins.formatNumber(number, pattern, decimalSeparator, groupingSeparator)
Section titled “ins.formatNumber(number, pattern, decimalSeparator, groupingSeparator)”Sayıyı Java DecimalFormat pattern’i ile formatlar.
ins.formatNumber(1234567.89, "#,##0.00", ",", ".");// → "1.234.567,89"
ins.formatNumber(3.14159, "0.00", ".", ",");// → "3.14"