.top-button {
		background-image: url(https://confluence.twin24.ai/download/thumbnails/23986188/baseline_keyboard_arrow_up_white_18dp.png) !important;
		background-position: center;
		background-color: #47a7f5 !important;
		background-repeat: no-repeat;
		box-shadow: -1px 1.5px 3px #999;
		color: #47a7f5 !important;
		border-radius:50px !important;
        position: fixed;
        bottom: 45px;
        left: 93.5%;
        width: 50px;
		height: 50px !important;
        font-size: 12px !important;
        padding: 14.5px !important;
		z-index: 2;
}
.top-button:hover{
		background-color: #65b9ff !important;
        color: #65b9ff !important;
}
.page-header{
		background-color: #232838;
	    background-repeat: no-repeat;
	    background-position: center;
		width: auto;
    	height: 100px;
		background-image: url(https://confluence.twin24.ai/download/attachments/23986188/logo_twin-02.png);
		background-size: 10em;
        color: #fff;
        font-size: 20px;
        padding: 20px;
}
.page-footer{
		background-color: #232838;
		background-image: url(https://confluence.twin24.ai/download/thumbnails/23986188/decorated-pattern-dark.png);
		width: auto;
    	height: 10px;
        color: #fff;
		text-align: end;
    	font: small-caption;
    	padding-inline-end: 30px;
    	padding-top: 200px;
    	padding-bottom: 30px;
}
.page-headline{
		background-image: url(https://confluence.twin24.ai/download/thumbnails/23986188/Solid256dot8_2changed.png);
    	background-repeat: no-repeat;
    	background-position-x: -227px;
    	background-position-y: center;
    	padding: 20px;
		background-color: #007bff;
		width: auto;
    	height: 10px;
        color: #fff;
		text-align: center;
    	font: caption;
    	font-weight: 600;
}
.tabs-menu{
    	padding-left: 85% !important;
}

На этой странице:

Функции общего назначения

del(varName string)

Назначение: удаление локальной или модульной переменной.

Аргументы:

1. varName – название переменной в виде строки. Может начинаться с префикса области видимости переменной. Если префикс опущен то считается, что переменная локальная.

На этой странице:

Функции общего назначения

del(varName string)

Назначение: удаление локальной или модульной переменной.

Аргументы:

1. varName – название переменной в виде строки. Может начинаться с префикса области видимости переменной. Если префикс опущен то считается, что переменная локальная.

Возвращаемое значение: отсутствует.

$localVar = 123
#moduleVar = true
del("$localVar")   // Удаляет локальную переменную $localVar
del("localVar")    // Тоже самое что и del("$localVar")
del("#moduleVar")  // Удаляет переменную с областью видимости в пределах модуля 

setClientTimezoneOffset(offset int)

Назначение: изменяет текущее смещение временной зоны собеседника бота.

Аргументы:

1. offset – смещение временной зоны в минутах.

Возвращаемое значение: отсутствует.

Примечание: вызов этой функции также приведёт к изменению значений системных переменных now, today и time согласно новой временной зоне.

setClientTimezoneOffset(-1800)

asBool(obj any) bool

Назначение: преобразует аргумент к булеву значению.

Аргументы:

1. obj – любое значение для преобразования.

Возвращаемое значение: булево значение.

Примечание: в BPL все значения могут быть преобразованы к булеву типу.

$bool = asBool(nil) // $bool содержит false
$bool = asBool("")  // $bool содержит false
$bool = asBool(0)   // $bool содержит false
$bool = asBool([])  // $bool содержит true
$bool = asBool(123) // $bool содержит true

asString(obj any) string

Назначение: преобразует аргумент к строковому значению.

Аргументы:

1. obj – любое значение для преобразования.

Возвращаемое значение: строковое значение.

Примечание: в BPL все значения могут быть преобразованы к строковому типу.

$str = asString(123)  // $str равно "123"
$str = asString(1.23) // $str равно "1.23"
$str = asString(true) // $str равно "true"
$str = asString({1: "a b c", 2: 0.5}) // $str равно "{1: "a b c", 2: 0.5}"

asInt(obj any) int

Назначение: преобразует аргумент к целочисленному значению.

Аргументы:

1. obj – любое значение для преобразования.

Возвращаемое значение: целочисленное значение, 0 в случае невозможности преобразования.

$int = asInt(5.67)  // $int равно 5
$int = asInt("123") // $int равно 123
$int = asInt(true)  // $int равно 1
$int = asInt(nil)   // $int равно 0
$int = asInt("abc") // $int равно 0

asFloat(obj any) float

Назначение: преобразует аргумент к вещественному числу.

Аргументы:

1. obj – любое значение для преобразования.

Возвращаемое значение: вещественное число, 0 в случае невозможности преобразованияВозвращаемое значение: отсутствует.

$localVar$float = 123
#moduleVarasFloat("5.67") // $float равно 5.67
$float = true
del("$localVar"asFloat(123)    // Удаляет локальную переменную $localVar
del("localVar") $float равно 123.0
$float = asfloat(true)   // Тоже$float самое что и del("$localVar")
del("#moduleVar")равно 1.0
$float = asfloat(nil)    // $float Удаляет переменную с областью видимости в пределах модуля 

setClientTimezoneOffset(offset int)

равно 0.0
$float = asFloat("abc")  // $float равно 0.0

Математические функции

math.pos(num mixed) number

Назначение: фактически преобразует аргумент к числу. Эквивалент унарной операции "+"Назначение: изменяет текущее смещение временной зоны собеседника бота.

Аргументы:

1. offset – смещение временной зоны в минутахnum – произвольное значение, которое будет преобразовано к числу.

Возвращаемое значение: отсутствуетчисло.

Примечание: вызов этой функции также приведёт к изменению значений системных переменных now, today и time согласно новой временной зоне.

setClientTimezoneOffset(-1800)

asBool(obj any) bool

$a = math.pos(true)  // $a будет равно 1
$a = math.pos(false) // $a будет равно 0
$a = math.pos(nil)   // $a будет равно 0
$a = +true           // $a будет равно 1, то же, что и math.pos(true)

math.neg(num number) number

Назначение: меняет знак числа. Эквивалент унарной операции "-"Назначение: преобразует аргумент к булеву значению.

Аргументы:

1. obj – любое значение для преобразованияnum – произвольное число, у которого изменится знак на противоположный.

Возвращаемое значение: булево значение.

Примечание: в BPL все значения могут быть преобразованы к булеву типу.

число со знаком обратному исходному.

$bool$a = asBool(nilmath.neg(-1) // $a $boolбудет содержитравно false1
$bool$a = asBool(""math.neg(1)  // $a $boolбудет содержитравно false-1
$bool$a = asBool(math.neg(0)   // $bool$a будет содержитравно false0
$bool$a = asBool-([])-10)       // $bool$a содержитбудет true
$bool = asBool(123) // $bool содержит true

asString(obj any) string

равно 10, то же, что и math.neg(-10)

math.inv(num number) number

Назначение: инверсия бит числа. Эквивалент унарной операции "~"Назначение: преобразует аргумент к строковому значению.

Аргументы:

1. obj – любое значение для преобразованияnum – произвольное число, у которого инвертируются биты.

Возвращаемое значение: строковое значениеинвертированное число.

Примечание: в BPL все значения могут быть преобразованы к строковому типу.

$str$a = asStringmath.inv(1235)  // $str$a равно "123"
$str-6
$a = asString(1.23) // $str равно "1.23"
$str = asString(true) // $str равно "true"
$str = asString({1: "a b c", 2: 0.5}) // $str равно "{1: "a b c", 2: 0.5}"

asInt(obj any) int

~5          // то же, что и предыдущая строка

math.not(num number) bool

Назначение: логическое отрицание числа. Эквивалент унарной операции "!"Назначение: преобразует аргумент к целочисленному значению.

Аргументы:

1. obj – любое значение для преобразованияnum – произвольное число.

Возвращаемое значение:целочисленное значение, 0 в случае невозможности преобразования true, если num не равно 0 и false в противном случае.

$int$a = asIntmath.not(5.67)  // $int$a равно 5false
$int$a = asInt("123"math.not(0) // $int$a равно 123true
$int$a = asInt(true)!0  // $int равно 1
$int = asInt(nil)   // $intто равно 0
$int = asInt("abc") // $int равно 0

asFloat(obj any) float

же, что и предыдущая строка

math.add(num1 number, num2 number, precision int = 12) number

Назначение: сложение чисел. Эквивалент бинарной операции "+"Назначение: преобразует аргумент к вещественному числу.

Аргументы:

1. obj – любое значение для преобразования.

Возвращаемое значение: вещественное число, 0 в случае невозможности преобразования.

1. num1 – первое слагаемое.
2. num2 – второе слагаемое.
3. precision – точность вычислений, количество цифр после запятой. Значение по умолчанию 12, максимальное – 14.

Возвращаемое значение: сумма чисел.

$float$a = asFloat("5.67")math.add(1.5, 3.5)         // $float$a равно 5.67
$float$a = asFloat(123)    // $float равно 123.0
$float = asfloat(true)   // $float равно 1.0
$float = asfloat(nil)1.5 + 3.5                  // $float равно 0.0
$float то же, что и предыдущая строка
$a = asFloat("abc")  math.add(1.000006, 2.1, 5) // $float$a равно 03.010001

Математические функции

math.

...

sub(num1 number, num2 number, precision int = 12) number

Назначение: фактически преобразует аргумент к числу разность чисел. Эквивалент унарной бинарной операции "+-".

Аргументы:

1. num – произвольное значение, которое будет преобразовано к числу.

Возвращаемое значение: число.

1. num1 – уменьшаемое.
2. num2 – вычитаемое.
3. precision – точность вычислений, количество цифр после запятой. Значение по умолчанию 12, максимальное – 14.

Возвращаемое значение: разность чисел.

$a = math.pos(truesub(1.5, 3.5)  // $a будет равно 1
$a = math.pos(false) // $a будет равно 0-2
$a = math.pos(nil)   // $a будет равно 0
$a = +true1.5 - 3.5                  // $a будет равно 1, то же, что и предыдущая строка
$a = math.pos(true)sub(2.100006, 1.1, 5) // $a равно 1.00001

math.

...

mul(num1 number, num2 number, precision int = 12) number

Назначение: меняет знак числа произведение чисел. Эквивалент унарной бинарной операции "-*".

Аргументы:

1. num1 – первый множитель.
2. num2 – второй множитель.
3. precision – точность вычислений, количество цифр после запятой. Значение по умолчанию 12, максимальное – 14num – произвольное число, у которого изменится знак на противоположный.

Возвращаемое значение: число со знаком обратному исходномупроизведение чисел.

$a = math.negmul(-1) // $a будет равно 1
$a = math.neg(1).5, 3.5)         // $a будет равно -15.25
$a = math.neg(0)  // $a будет равно 0
$a = -(-10)1.5 * 3.5              // $a будет равно 10,// то же, что и предыдущая строка
$a = math.neg(-10)mul(1.2345, 1.234, 5) // $a равно 1.52337

math.

...

div(num1 number, num2 number, precision int = 12) number

Назначение: инверсия бит числа частное чисел. Эквивалент унарной бинарной операции "~/".

Аргументы:

1. num1 – делимое.
2. num2 – делитель.
3. precision – точность вычислений, количество цифр после запятой. Значение по умолчанию 12, максимальное – 14num – произвольное число, у которого инвертируются биты.

Возвращаемое значение: инвертированное числочастное чисел.

$a = math.invdiv(1.5, 3.5) // $a равно -60.428571428571
$a = ~5 1.5 / 3.5          // то же, что и предыдущая строка
$a = math.

...

div(1, 3, 5)  // $a равно 0.33333

math.idiv(num1 number, num2 number) int

Назначение: целочисленное деление чисел. Эквивалент бинарной операции "\

...

Назначение: логическое отрицание числа. Эквивалент унарной операции "!".

Аргументы:

1. num1 – делимое.
2. num num2 – произвольное числоделитель.

Возвращаемое значение:  true, если num не равно 0 и false в противном случаецелая часть частного чисел.

$a = math.notidiv(2.5, 0.3) // $a равно false8
$a = math.not(0) // $a равно true
$a = !0  2.5 \ 0.3           // то же, что и предыдущая строка

math.

...

mod(num1 number, num2 number, precision int = 12) number

Назначение: сложение остаток от деления двух чисел. Эквивалент бинарной операции "+%".

Аргументы:

1. num1 – первое слагаемоеделимое.
2. num2 – второе слагаемоеделитель.
3. precision – точность вычислений, количество цифр после запятой. Значение по умолчанию 12, максимальное – 14.

Возвращаемое значение: сумма чиселостаток от деления.

$a = math.addmod(13.5, 31.5)         // $a равно 0.5
$a = 13.5 +% 31.5                  // то же, что и предыдущая строка
$a = math.addmod(1.000006/3, 2.1/7, 5) // $a равно 30.1000104762

math.

...

pow(

...

base number,

...

power number, precision int = 12) number

Назначение: разность чисел возведение числа base в степень power. Эквивалент бинарной операции "-**".

Аргументы:

1. num1 base – уменьшаемоеоснование.
2. num2 power – вычитаемоестепень.
3. precision – точность вычислений, количество цифр после запятой. Значение по умолчанию 12, максимальное – 14.

Возвращаемое значение:разность чисел результат возведения в степень.

$a = math.subpow(1.5, 3.5)         // $a равно -24.133513940947
$a = 1.5 -** 3.5                  // то же, что и предыдущая строка
$a = math.subpow(21.1000063, 17.1, 5) // $a равно 10.0000144166

math.

...

sqrt(num number, precision int = 12) number

Назначение: произведение чисел. Эквивалент бинарной операции "*". извлечение квадратного корня.

Аргументы:

1. num1 – первый множитель.
2. num2 – второй множительnum – число, из которого извлекается корень.
3. precision – точность вычислений, количество цифр после запятой. Значение по умолчанию 12, максимальное – 14.

Возвращаемое значение:произведение чисел квадратный корень либо ошибка, если число отрицательное.

$a = math.mulsqrt(1.5, 3.514)         // $a равно 5.25
$a = 1.5 * 3.5                  // то же, что и предыдущая строка1.772004514667
$a = math.mulsqrt(1.2345, 1.2347, 5) // $a равно 10.5233730384

math.

...

round(

...

num number,

...

precision int

...

) number

Назначение: частное чисел. Эквивалент бинарной операции "/" округление числа до требуемого знака после запятой.

Аргументы:

1. num1 – делимое.
2. num2 – делительnum – число для округления.
3. precision – точность вычисленийокругления, количество цифр после запятой. Значение по умолчанию 12, максимальное Максимальное значение – 14.

Возвращаемое значение:частное чисел. округлённое с заданной точностью число.

$a = math.divround(13.514159265358979323846264338327950288419716, 3.517) // $a равно 03.4285714285711415926535898
$a = 1.5 / math.round(3.514159265358979323846264338327950288419716, 2)         // то$a же, что и предыдущая строкаравно 3.14
$a = math.divround(1, 3.14159265358979323846264338327950288419716, 50)  // $a равно 0.333333

math.

...

rand(

...

min int, max int) int

Назначение: целочисленное деление чисел. Эквивалент бинарной операции "\" генерация псевдослучайного числа в диапазоне от min до max включительно.

Аргументы:

1. min - минимальное значение числа.
2. max - максимальное значение числа
3. num1 – делимое.
4. num2 – делитель.

Возвращаемое значение:целая часть частного чисел число в диапазоне от min до max.

$a$r = math.idiv(2.5, 0.3) // $a равно 8
$a = 2.5 \ 0.3           // то же, что и предыдущая строка

math.mod(num1 number, num2 number, precision int = 12) number

Назначение: остаток от деления двух чисел. Эквивалент бинарной операции "%".

Аргументы:

1. num1 – делимое.
2. num2 – делитель.
3. precision – точность вычислений, количество цифр после запятой. Значение по умолчанию 12, максимальное – 14.

rand(-10, 10)

Функции для работы со строками

str.len(str string) int

Назначение: определение длины строки в символах.

Аргументы:

1. str – строка, длину которой необходимо определить.

Возвращаемое значение: целое число, равное количеству символов в строке.

$str = "Какая-то строка"
$len = str.len($str) // $len будет содержать 15

str.lower(str string) string

Назначение: преобразование символов строки в нижний регистр.

Аргументы:

1. str – строка, которую необходимо преобразовать.

Возвращаемое значение: строка, все символы которой находятся в нижнем регистреВозвращаемое значение: остаток от деления.

$a$str = "СтРоКа"
$lower = mathstr.mod(3.5, 1.5)   lower($str) // $a$lower равно 0.5
$a = 3.5 % 1.5             // то же, что и предыдущая строка
$a = math.mod(1/3, 2/7, 5) // $a равно 0.04762

math.pow(base number, power number, precision int = 12) number

Назначение: возведение числа base в степень power. Эквивалент бинарной операции "**".

Аргументы:

будет содержать "строка" 

str.upper(str string) string

Назначение: преобразование символов строки в верхний регистр.

Аргументы:

1. str – строка, которую необходимо преобразовать
2. base – основание.
3. power – степень.
4. precision – точность вычислений, количество цифр после запятой. Значение по умолчанию 12, максимальное – 14.

Возвращаемое значение: результат возведения в степеньстрока, все символы которой находятся в верхнем регистре.

$a$str = "СтРоКа"
$upper = mathstr.pow(1.5, 3.5)    upper($str) // $a$lower равно 4.133513940947
$a = 1.5 ** 3.5            // то же, что и предыдущая строка
$a = math.pow(1.3, 7.1, 5) // $a равно 0.44166

math.sqrt(num number, precision int = 12) number

Назначение: извлечение квадратного корня.

Аргументы:

1. num – число, из которого извлекается корень.
2. precision – точность вычислений, количество цифр после запятой. Значение по умолчанию 12, максимальное – 14.

будет содержать "СТРОКА" 

str.ucfirst(str string) string

Назначение: преобразование первого символа строки в верхний регистр.

Аргументы:

1. str – строка, первый символ которой необходимо преобразовать.

Возвращаемое значение: строка, в которой первый символ записан в верхнем регистре.

$str = str.ucfirst("строка") // $str будет содержать "Строка" 

str.lcfirst(str string) string

Назначение: преобразование первого символа строки в нижний регистр.

Аргументы:

1. str – строка, первый символ которой необходимо преобразовать.

Возвращаемое значение: строка, в которой первый символ записан в нижнем регистреВозвращаемое значение: квадратный корень либо ошибка, если число отрицательное.

$a$str = mathstr.sqrt(3.14ucfirst("Строка")   // $a$str равно 1.772004514667
$a = math.sqrt(1.7, 5) // $a равно 0.30384

math.round(num number, precision int) number

будет содержать "строка" 

str.letter(str string, index int) string

Назначение: получение указанного символа строкиНазначение: округление числа до требуемого знака после запятой.

Аргументы:

1. num – число для округленияstr – строка, символ которой требуется получить.
2. precision – точность округления, количество цифр после запятой. Максимальное значение – 14index – целое число, определяющее позицию символа в строке, начиная с 0. Если это число отрицательное, то отсчёт начинается с конца строки.

Возвращаемое значение:  округлённое с заданной точностью числострока, соответствующая указанному символу, либо пустая строка, если символа с такой позицией не существует.

$a$str = math.round(3.14159265358979323846264338327950288419716, 17) // $a равно 3.1415926535898
$a"Слово"
$firstLetter = mathstr.roundletter(3.14159265358979323846264338327950288419716$str, 20)  // $a равно 3.14
$aПервая буква
$lastLetter = mathstr.roundletter(3.14159265358979323846264338327950288419716$str, 0-1)  // $aПоследняя равно 3буква

...

str.

...

first(

...

str string,

...

index int = 0)

...

string

Назначение: генерация псевдослучайного числа в диапазоне от min до max включительно получение указанного символа строки, начиная с начала строки.

Аргументы:

1. min - минимальное значение числа.
2. max - максимальное значение числа.

1. str – строка, символ которой требуется получить.
2. index – целое число, определяющее позицию символа с начала строки, начиная с 0. При этом знак числа игнорируется. Значение по умолчанию – 0 (первый символ).

Возвращаемое значение: строка, соответствующая указанному символу, либо пустая строка, если символа с такой позицией не существуетВозвращаемое значение: число в диапазоне от min до max.

$r$str = "Слово"
$firstLetter = str.first($str)      // Первая буква
$secondLetter = mathstr.randfirst(-10$str, 10)

Функции для работы со строками

...

1)  // Вторая буква

str.last(str string, index int = 0)

...

string

Назначение: определение длины строки в символах получение указанного символа строки, начиная с конца строки.

Аргументы:

1. str – строка, длину символ которой необходимо определитьтребуется получить.
2. index – целое число, определяющее позицию символа с конца строки, начиная с 0. При этом знак числа игнорируется. Значение по умолчанию – 0 (последний символ).

Возвращаемое значение: строка, соответствующая указанному символу, либо пустая строка, если символа с такой позицией не существуетВозвращаемое значение: целое число, равное количеству символов в строке.

$str = "Какая-то строкаСлово"
$len$lastLetter = str.lenlast($str)       // $len будет содержать 15 Последняя буква
$penultLetter = str.last($str, 1)  // Предпоследняя буква

str.

...

concat(str1 string, str2 string) string

Назначение: преобразование символов объединяет две строки в нижний регистродну.

Аргументы:

1. str1 – строка, которая объединяется.
2. str2 str – строка, которую необходимо преобразоватьс которой объединяются.

Возвращаемое значение: новая строка, все символы которой находятся в нижнем регистре, состоящая из первой строки, справа от которой добавлена вторая строка.

$str$str1 = "один"
$str2 = "СтРоКадва"
$lower$str = str.lower($strconcat($str1, $str2) // $lower$str будет содержать "строкаодиндва" 

str.

...

sub(str string, offset int, length int = nil) string

Назначение: преобразование символов строки в верхний регистр возвращает подстроку строки str, начинающейся с offset символа по счету и длиной length символов.

Аргументы:

1. str – исходная строка, которую необходимо преобразовать..
2. offset – если offset неотрицательный, то возвращаемая подстрока начинается с позиции offset от начала строки, считая от нуля.
   Если offset отрицательный, то возвращаемая подстрока начинается с позиции, отстоящей на offset символов от конца строки str.
   Если str меньше offset символов, то будет возвращена пустая строка.
3. length – если length положительный, то возвращаемая строка будет не длиннее length символов, начиная с параметра offset (в зависимости от длины string).
   Если length отрицательный, то будет отброшено указанное этим аргументом число символов с конца строки string (после того как будет вычислена стартовая позиция, если offset отрицательный). Если при этом позиция начала подстроки, определяемая аргументом offset, находится в отброшенной части строки или за ней, то возвращается пустая строка. 
   Если параметр length задан и равен 0, то будет возвращена пустая строка.
   Если параметр length опущен или nil, то будет возвращена подстрока, начинающаяся с позиции, указанной параметром offset и длящейся до конца строки.

Возвращаемое значение: часть str или пустая строкаВозвращаемое значение: строка, все символы которой находятся в верхнем регистре.

$str$sub = "СтРоКа"
$upperstr.sub("abcdef", 1)      // $sub равен bcdef
$sub = str.upper($strsub("abcdef", 1, 3)   // $sub $lowerравен будетbcd
$sub содержать= str.sub("СТРОКА" 

str.ucfirst(str string) string

Назначение: преобразование первого символа строки в верхний регистр.

Аргументы:

1. str – строка, первый символ которой необходимо преобразовать.

Возвращаемое значение: строка, в которой первый символ записан в верхнем регистре.

$strabcdef", 0, 4)   // $sub равен abcd
$sub = str.sub("abcdef", 0, 8)   // $sub равен abcdef
$sub = str.ucfirstsub("строка")abcdef", -1, 1)  // $str$sub будетравен содержать "Строка" f
$sub = str.

...

Назначение: преобразование первого символа строки в нижний регистр.

Аргументы:

1. str – строка, первый символ которой необходимо преобразовать.

Возвращаемое значение: строка, в которой первый символ записан в нижнем регистре.

$strsub("abcdef", -1)     // $sub равен f
$sub = str.ucfirstsub("Строкаabcdef", -2)     // $str$sub будетравен содержать "строка" ef
$sub = str.

...

Назначение: получение указанного символа строки.

Аргументы:

1. str – строка, символ которой требуется получить.
2. index – целое число, определяющее позицию символа в строке, начиная с 0. Если это число отрицательное, то отсчёт начинается с конца строки.

Возвращаемое значение: строка, соответствующая указанному символу, либо пустая строка, если символа с такой позицией не существует.

$str = "Слово"
$firstLetter = str.letter($str, 0)  // Первая буква
$lastLetter = str.letter($strsub("abcdef", -3, 1)  // $sub равен d
$sub = str.sub("abcdef", 0, -1)  // $sub равен abcde
$sub = str.sub("abcdef", 2, -1)  // $sub равен cde
$sub = str.sub("abcdef", 4, -4)  // $sub равен пустой строке
$sub = str.sub("abcdef", -3, -1)  // $sub Последняяравен букваde

str.

...

join(arr Collection, separator string = "") string

Назначение: получение указанного символа строки, начиная с начала строки объединяет элементы коллекции (кортежа, списка или ассоциативного массива) в строку.

Аргументы:

1. str – строка, символ которой требуется получитьarr – коллекция элементов для объединения.
2. index – целое число, определяющее позицию символа с начала строки, начиная с 0. При этом знак числа игнорируется. Значение по умолчанию – 0 (первый символ).separator – разделитель элементов коллекции. По умолчанию равен пустой строке.

Возвращаемое значение: строка, соответствующая указанному символу, либо пустая строка, если символа с такой позицией не существуетновая строка, составленная из всех элементов коллекции отделённых между собой разделителем.

$str = "Слово"
$firstLetter str.join([1, 2, 3, 4, 5], "-")             // $str будет содержать "1-2-3-4-5"
$str = str.first($str)join(("a", "b", "c"))                  // $str будет Перваясодержать буква"abc"
$secondLetter$str = str.first($str, 1)  // Вторая буква

str.last(str string, index int = 0) string

Назначение: получение указанного символа строки, начиная с конца строки.

Аргументы:

1. str – строка, символ которой требуется получить.
2. index – целое число, определяющее позицию символа с конца строки, начиная с 0. При этом знак числа игнорируется. Значение по умолчанию – 0 (последний символ).

Возвращаемое значение: строка, соответствующая указанному символу, либо пустая строка, если символа с такой позицией не существует.

$str = "Слово"
$lastLetter = str.last($strjoin({"a": "один", "b": "два"}, " + ") // $str будет содержать "один + два"
$str = str.join(["одно"], "/")                    // $str будет содержать "одно"
$str = str.join([], "/")       // Последняя буква
$penultLetter = str.last($str, 1)                   // Предпоследняя буква$str будет содержать ""

str.

...

split(

...

str string,

...

separator string = "", limit int = 0) List

Назначение: разбивает строку на части, используя separator в качестве разделителя

...

Назначение: объединяет две строки в одну.

Аргументы:

1. str1 str – строка , которая объединяется.для разделения.
2. separator – разделитель. Если равен пустой строке, то разбиение происходит посимвольно.
3. limit – необязательный параметр, равный максимальному количеству частей, на которые будет разбита строка. Если limit равен 0, то без ограничений. Если limit является положительным, возвращаемый список будет содержать максимум limit элементов. При этом последний элемент будет содержать остаток строки str. Если limit отрицательный, то будут возвращены все компоненты, кроме последних limitstr2 – строка, с которой объединяются.

Возвращаемое значение:  новая строка, состоящая из первой строки, справа от которой добавлена вторая список подстрок, на которые была разбита строка.

$str1$letters = str.split("один"
$str2 = "два"
$strабвгде")             // Получили список букв слова
$words = str.concat($str1, $str2)split("один два три", " ")    // $strПолучили будетсписок содержать "одиндва" слов
$words = str.

...

split("один два три", " ", 2) // words содержит ["один", "два три"]

str.replace(str string, search string, replace string) string

Назначение: ищет все вхождения подстроки в строке и заменяет их на заданное значение

...

Назначение: возвращает подстроку строки str, начинающейся с offset символа по счету и длиной length символов.

Аргументы:

1. str – исходная строка в которой выполняется замена.
2. offset – если offset неотрицательный, то возвращаемая подстрока начинается с позиции offset от начала строки, считая от нуля.
   Если offset отрицательный, то возвращаемая подстрока начинается с позиции, отстоящей на offset символов от конца строки str.
   Если str меньше offset символов, то будет возвращена пустая строка.
3. length – если length положительный, то возвращаемая строка будет не длиннее length символов, начиная с параметра offset (в зависимости от длины string).
   Если length отрицательный, то будет отброшено указанное этим аргументом число символов с конца строки string (после того как будет вычислена стартовая позиция, если offset отрицательный). Если при этом позиция начала подстроки, определяемая аргументом offset, находится в отброшенной части строки или за ней, то возвращается пустая строка. 
   Если параметр length задан и равен 0, то будет возвращена пустая строка.
   Если параметр length опущен или nil, то будет возвращена подстрока, начинающаяся с позиции, указанной параметром offset и длящейся до конца строки.

Возвращаемое значение: часть str или пустая строка.

$sub = str.sub("abcdef", 1)      // $sub равен bcdef
$sub = str.sub("abcdef", 1, 3)   // $sub равен bcd
$sub = str.sub("abcdef", 0, 4)   // $sub равен abcd
$sub = str.sub("abcdef", 0, 8)   // $sub равен abcdef
$sub = str.sub("abcdef", -1, 1)  // $sub равен f
$sub = str.sub("abcdef", -1)     // $sub равен f
$sub = str.sub("abcdef", -2)     // $sub равен ef
$sub = str.sub("abcdef", -3, 1)  // $sub равен d
$sub = str.sub("abcdef", 0, -1)  // $sub равен abcde
$sub = str.sub("abcdef", 2, -1)  // $sub равен cde
$sub = str.sub("abcdef", 4, -4)  // $sub равен пустой строке
$sub = str.sub("abcdef", -3, -1) // $sub равен de

str.join(arr Collection, separator string = "") string

Назначение: объединяет элементы коллекции (кортежа, списка или ассоциативного массива) в строку.

Аргументы:

1. arr – коллекция элементов для объединения.
2. separator – разделитель элементов коллекции. По умолчанию равен пустой строке.

Возвращаемое значение: новая строка, составленная из всех элементов коллекции отделённых между собой разделителем.

1. search – подстрока, которая ищется в исходной строке.
2. replace – строка замены.

Возвращаемое значение: новая строка, в которой все search заменены на replace.

$str = str.replace("мама мыла раму", "рам", "Даш") // $str содержит "мама мыла Дашу"

str.rreplace(str string, pattern string, replace string) string

Назначение: ищет все вхождения соответствующие регулярному выражению в строке и заменяет их на заданное значение.

Аргументы:

1. str – строка в которой выполняется замена.
2. pattern – шаблон регулярного выражения соответствия которому ищутся в исходной строке. 
3. replace – строка замены.

Возвращаемое значение: новая строка, в которой все cоответствия pattern заменены на replace.

<b>Примечание:</b> в качестве регулярных выражений используются <a href="http://ru.wikipedia.org/wiki/PCRE" target="_blank">Perl совместимые регулярные выражения (PCRE)</a>. 

<a href="http://www.shtogrin.com/library/web/pcre/" target="_blank">Ссылка на документацию и примеры регулярных выражений.</a> 

<a href="http://myregexp.com/" target="_blank">Онлайн редактор регулярных выражений.</a>

$str = str.rreplace("раз 1, два 2, три 3", "/[0-9]/", "") // $str содержит "раз, два, три"

str.match(str string, pattern string) bool

Назначение: выполняет проверку данной строки регулярному выражению.

Аргументы:

1. str – строка для сопоставления с регулярным выражением.
2. pattern – шаблон регулярного выражения. 

Возвращаемое значение: возвращает true, если строка соответствует регулярному выражению и false –в противном случае.

<b>Примечание:</b> в качестве регулярных выражений используются <a href="http://ru.wikipedia.org/wiki/PCRE" target="_blank">Perl совместимые регулярные выражения (PCRE)</a>. 

<a href="http://www.shtogrin.com/library/web/pcre/" target="_blank">Ссылка на документацию и примеры регулярных выражений.</a> 

<a href="http://myregexp.com/" target="_blank">Онлайн редактор регулярных выражений.</a>

$isIntNumber = str.match("1.234", "/^[0-9]+$/") // $isIntNumber будет равен false
$isIntNumber = str.match("1234", "/^[0-9]+$/")  // $isIntNumber будет равен true

str.distance(str1 string, str2 string) number

Назначение: вычисляет степень сходства двух строк.

Аргументы:

1. str1 – первая строка для сравнения.
2. str2 – вторая строка для сравнения. 

Возвращаемое значение: возвращает число от 0 до 1 включительно, определяющее степень сходства двух строк: 1 – строки эквивалентны, 0 – строки абсолютно разные.

<b>Примечание:</b> функция фактически вычисляет
<a href="https://en.wikipedia.org/wiki/Word_error_rate" target="_blank">Word Error Rate.</a>

$d = str.distance("", "abc")              // $d равен 0
$d = str.distance("Да", "да

$str = str.join([1, 2, 3, 4, 5], "-")             // $str будет содержать "1-2-3-4-5"
$str = str.join(("a", "b", "c"))                  // $str будет содержать "abc"
$str = str.join({"a": "один", "b": "два"}, " + ") // $str будет содержать "один + два"
$str = str.join(["одно"], "/")                    // $str будет содержать "одно"
$str = str.join([], "/")             // $d равен 1
$d = str.distance("корыто", "открыто")    // $d равен 0.571
$d = str.distance("Да, верно", "таверна") // $str будет содержать ""

str.split(str string, separator string = "", limit int = 0) List

Назначение: разбивает строку на части, используя separator в качестве разделителя.

Аргументы:

1. str – строка для разделения.
2. separator – разделитель. Если равен пустой строке, то разбиение происходит посимвольно.
3. limit – необязательный параметр, равный максимальному количеству частей, на которые будет разбита строка. Если limit равен 0, то без ограничений. Если limit является положительным, возвращаемый список будет содержать максимум limit элементов. При этом последний элемент будет содержать остаток строки str. Если limit отрицательный, то будут возвращены все компоненты, кроме последних limit.

Возвращаемое значение: список подстрок, на которые была разбита строка.

$letters = str.split("абвгде")             // Получили список букв слова
$words = str.split("один два три", " ")    // Получили список слов
$words = str.split("один два три", " ", 1) // words содержит ["один", "два три"]

str.replace(str string, search string, replace string) string

Назначение: ищет все вхождения подстроки в строке и заменяет их на заданное значение.

Аргументы:

1. str – строка в которой выполняется замена.
2. search – подстрока, которая ищется в исходной строке.
3. replace – строка замены.

 $d равен 0.625
$d = str.distance("жутко косые бананы", "жуй кокосы, ешь бананы") // $d равен 0.714
$d = str.distance("сошел с ума от раны", "Пошел он в пусурманы")  // $d равен 0.45
$d = str.distance("ёж", "дезоксирибонуклеиновая кислота")         // $d равен 0

Функции хэширования

hash.of(text string, algo string = "md5", binary bool = false) string

Назначение: вычисляет хэш строки согласно указанному алгоритму.

Аргументы:

1. text – произвольная строка для хэширования.
2. algo – название алгоритма хэширования. По умолчанию используется алгоритм md5.
3. binary – когда установлено в true, выводит необработанные двоичные данные. При false выводит данные в шестнадцатеричной кодировке в нижнем регистре. По умолчания равен false.

Возвращаемое значение:возвращает строку, содержащую вычисленный хеш-код в шестнадцатеричной кодировке в нижнем регистре. Если binary задан как true, то возвращается хеш-код в виде бинарных данных. В случае ошибки (например, если указан недопустимый алгоритм хэширования) возвращает пустую строку.

Допустимые значения алгоритмов хэширования:

• md2
• md4
• md5
• sha1
• sha224
• sha256
• sha384
• sha512/224
• sha512/256
• sha512
• sha3–224
• sha3–256
• sha3–384
• sha3–512
• ripemd128
• ripemd160
• ripemd256
• ripemd320
• whirlpool
• tiger128,3
• tiger160,3
• tiger192,3
• tiger128,4
• tiger160,4
• tiger192,4
• snefru
• snefru256
• gost
• gost–crypto
• adler32
• crc32
• crc32b
• crc32c
• fnv132
• fnv1a32
• fnv164
• fnv1a64
• joaat
• murmur3a
• murmur3c
• murmur3f
• xxh32
• xxh64
• xxh3
• xxh128
• haval128,3
• haval160,3
• haval192,3
• haval224,3
• haval256,3
• haval128,4
• haval160,4
• haval192,4
• haval224,4
• haval256,4
• haval128,5
• haval160,5
• haval192,5
• haval224,5
• haval256,5

Примечание: если третий параметр true, то передавать возвращаемое функцией значение в качестве сообщения бота или его части нельзя. Это приведёт к падению ботаВозвращаемое значение: новая строка, в которой все search заменены на replace.

$str$hash = strhash.replaceof("мама мыла раму", "рам", "Даш") // $str содержит "мама мыла Дашу"

str.rreplace(str string, pattern string, replace string) string

Назначение: ищет все вхождения соответствующие регулярному выражению в строке и заменяет их на заданное значение.

Аргументы:

1. str – строка в которой выполняется замена.
2. pattern – шаблон регулярного выражения соответствия которому ищутся в исходной строке. 
3. replace – строка замены.

Возвращаемое значение: новая строка, в которой все cоответствия pattern заменены на replace.

Наглый коричневый лисёнок прыгает вокруг ленивой собаки.")                 // $hash будет содержать bff8b4bc8b5c1c1d5b3211dfb21d1e76
$hash = hash.of("Наглый коричневый лисёнок прыгает вокруг ленивой собаки.", "ripemd160")    // $hash будет содержать 8817ca339f7f902ad3fb456150a1bb9b4cb5dde9
$hash = hash.of("Наглый коричневый лисёнок прыгает вокруг ленивой собаки.", "sha256", true) // $hash будет содержать бинарную строку (содержащую неотображаемые символы)

Функции кодирования/декодирования

codec.base64Encode(str string) string

<b>Назначение:</b> кодирует заданную строку в

<b>Примечание:</b> в качестве регулярных выражений используются <a href="httphttps://ru.wikipedia.org/wiki/PCREBase64" target="_blank">Perl совместимые регулярные выражения (PCRE)<>Base64</a>. 

<a href="http://www.shtogrin.com/library/web/pcre/" target="_blank">Ссылка на документацию и примеры регулярных выражений.</a> 

Аргументы:

1. str – произвольная строка для кодирования.

Возвращаемое значение: возвращает строку, закодированную в Base64.

$encoded = codec.base64Encode("Привет!") // $encoded будет содержать строку "0J/RgNC40LLQtdGCIQ=="

codec.base64Decode(str string) ?string

<b>Назначение:</b> декодирует заданную в 

<a href="httphttps://myregexp.com/ru.wikipedia.org/wiki/%D0%A0%D0%B0%D1%81%D1%81%D1%82%D0%BE%D1%8F%D0%BD%D0%B8%D0%B5_%D0%94%D0%B0%D0%BC%D0%B5%D1%80%D0%B0%D1%83_%E2%80%94_%D0%9B%D0%B5%D0%B2%D0%B5%D0%BD%D1%88%D1%82%D0%B5%D0%B9%D0%BD%D0%B0" target="_blank">Онлайн редактор регулярных выражений.</a>>Base64</a> строку.

Аргументы:

1. str – строка, закодированная в Base64.

Возвращаемое значение: возвращает раскодированную строку либо nil, если закодированная строка содержит символы, не входящие в алфавит символов Base64 кодировки.

$str$decoded = strcodec.rreplace("раз 1, два 2, три 3", "/[0-9]/", "") // $str содержит "раз, два, три"

str.match(str string, pattern string) bool

Назначение: выполняет проверку данной строки регулярному выражению.

Аргументы:

1. str – строка для сопоставления с регулярным выражением.
2. pattern – шаблон регулярного выражения. 

...

base64Decode("0J/RgNC40LLQtdGCIQ==") // $decoded будет содержать строку "Привет!"
$failed = codec.base64Decode("Привет!")               // $failed будет равен nil

codec.jsonEncode(value any) string

<b>Назначение:</b> кодирует заданное значение в

...

<b>Примечание:</b> в качестве регулярных выражений используются <a href="httphttps://ru.wikipedia.org/wiki/PCREJSON" target="_blank">Perl совместимые регулярные выражения (PCRE)<>json</a>. 

<a href="http://www.shtogrin.com/library/web/pcre/" target="_blank">Ссылка на документацию и примеры регулярных выражений.</a> 

Аргументы:

1. value – произвольное значение для кодирования.

Возвращаемое значение: возвращает значение в формате json.

$encoded = codec.jsonEncode((1, true, "a", {"a": 1, "b": 2})) // $encoded будет содержать строку '[1, true, "a", {"a": 1, "b": 2}]'

codec.jsonDecode(value string) any

<b>Назначение:</b> декодирует заданное в 
<a href="https://ru.wikipedia.org/wiki/JSON

<a href="http://myregexp.com/" target="_blank">Онлайн редактор регулярных выражений.</a>>json</a> значение.

Аргументы:

1. value – значение, закодированное в json.

Возвращаемое значение: возвращает раскодированное значение либо nil, в случае невозможности его раскодирования.

$isIntNumber$decoded = strcodec.matchjsonDecode("1.234"'[1, true, "/^[0-9]+$/") // $isIntNumber будет равен false
$isIntNumber = str.match("1234", "/^[0-9]+$/")  // $isIntNumber будет равен true

str.distance(str1 string, str2 string) number

Назначение: вычисляет степень сходства двух строк.

Аргументы:

1. str1 – первая строка для сравнения.
2. str2 – вторая строка для сравнения. 

Возвращаемое значение: возвращает число от 0 до 1 включительно, определяющее степень сходства двух строк: 1 – строки эквивалентны, 0 – строки абсолютно разные.

...

a", {"a": 1, "b": 2}]') // $decoded будет содержать список [1, true, "a", {"a": 1, "b": 2}]

Функции для работы с датой и временем

dt.add(d1 int|string, d2 int|string) string

Назначение: складывает две даты, заданные в виде строки либо как число секунд.

• Если хотя бы один из аргументов функции число секунд, то это число будет прибавлено к числу секунд другой даты.
• Если обе даты заданы строкой, то результат определяется по формуле d1 + abs(secondsOf(d1) - secondsOf(d2)), где abs – модуль числа (положительное значение), secondsOf – это дата, представленная как количество секунд, прошедших с начала 1970 года (даты до этого времени представлены отрицательным значением). 

Аргументы:

1. d1 – строка, представляющая собой дату в одном из допустимых форматов, или целое число, соответствующее количеству секунд.
2. d2 – аналогично первому аргументу.

Возвращаемое значение: возвращает новую дату и время в виде строки.

$d = strdt.distanceadd("2022-01-01 12:30:00", "abc"59)                    // $d равен 0 содержит строку "2022-01-01 12:30:59" 
$d = strdt.distanceadd("Да"3600, "да2022-01-01 12:30:00")                  // $d равен 1
$d = str.distance("корыто", "открыто")    // $d равен 0.571содержит строку "2022-01-01 13:30:00"
$d = strdt.distanceadd("Да, верно2022-01-02 02:00:00", "таверна2022-01-01 01:00:00") // $d равен 0.625
$d = str.distance("жутко косые бананы", "жуй кокосы, ешь бананы") // $d равен 0.714
$d = str.distance("сошел с ума от раны", "Пошел он в пусурманы")  // $d равен 0.45
$d = str.distance("ёж", "дезоксирибонуклеиновая кислота")         // $d равен 0

Функции хэширования

hash.of(text string, algo string = "md5", binary bool = false) string

Назначение: вычисляет хэш строки согласно указанному алгоритму.

Аргументы:

1. text – произвольная строка для хэширования.
2. algo – название алгоритма хэширования. По умолчанию используется алгоритм md5.
3. binary – когда установлено в true, выводит необработанные двоичные данные. При false выводит данные в шестнадцатеричной кодировке в нижнем регистре. По умолчания равен false.

...

содержит строку "2022-01-03 03:00:00"

dt.sub(d1 int|string, d2 int|string) int|string

Назначение: вычисляет разность двух дат, заданных в виде строк либо количеством секунд.

• Если обе даты заданы количеством секунд, то функция вернёт их разность в виде числа секунд.
• Если обе даты заданы строкой, то будет возвращено целое число, равное разности между датами в секундах.
• Если первый аргумент задан строкой даты, а второй – числом секунд, то результатом будет новая дата, равная разности даты и числа секунд.
• Если второй аргумент задан строкой даты, а первый числом секунд, то результатом будет ошибка.

Аргументы:

1. d1 – строка, представляющая собой дату в одном из допустимых форматов, или целое число, соответствующее количеству секунд.
2. d2 – аналогично первому аргументу.

Возвращаемое значение: возвращает новую дату и время в виде строки либо число секунд – разность дат

...

Допустимые значения алгоритмов хэширования:

• md2
• md4
• md5
• sha1
• sha224
• sha256
• sha384
• sha512/224
• sha512/256
• sha512
• sha3–224
• sha3–256
• sha3–384
• sha3–512
• ripemd128
• ripemd160
• ripemd256
• ripemd320
• whirlpool
• tiger128,3
• tiger160,3
• tiger192,3
• tiger128,4
• tiger160,4
• tiger192,4
• snefru
• snefru256
• gost
• gost–crypto
• adler32
• crc32
• crc32b
• crc32c
• fnv132
• fnv1a32
• fnv164
• fnv1a64
• joaat
• murmur3a
• murmur3c
• murmur3f
• xxh32
• xxh64
• xxh3
• xxh128
• haval128,3
• haval160,3
• haval192,3
• haval224,3
• haval256,3
• haval128,4
• haval160,4
• haval192,4
• haval224,4
• haval256,4
• haval128,5
• haval160,5
• haval192,5
• haval224,5
• haval256,5

Примечание: если третий параметр true, то передавать возвращаемое функцией значение в качестве сообщения бота или его части нельзя. Это приведёт к падению бота.

$hash$d = hashdt.of("Наглый коричневый лисёнок прыгает вокруг ленивой собаки.")sub(100, 50)                                      // $hash$d будетсодержит содержать bff8b4bc8b5c1c1d5b3211dfb21d1e7650
$hash$d = hashdt.of("Наглый коричневый лисёнок прыгает вокруг ленивой собаки.", "ripemd160")sub("2022-01-01 12:30:00", 3600)                  // $d $hashсодержит будет содержать 8817ca339f7f902ad3fb456150a1bb9b4cb5dde9
$hashстроку "2022-01-01 11:30:00"
$d = hashdt.of("Наглый коричневый лисёнок прыгает вокруг ленивой собаки.", "sha256", true) // $hash будет содержать бинарную строку (содержащую неотображаемые символы)

Функции кодирования/декодирования

codec.base64Encode(str string) string

<b>Назначение:</b> кодирует заданную строку в <a href="https://ru.wikipedia.org/wiki/Base64" target="_blank">Base64</a>.

Аргументы:

1. str – произвольная строка для кодирования.

Возвращаемое значение: возвращает строку, закодированную в Base64.

$encoded = codec.base64Encode("Привет!sub(3600, "2022-01-01 12:30:00")                  // Такой вызов недопустим и приведёт к остановке программы
$d = dt.sub("2022-01-01 01:00:00", "2022-01-01 00:00:00") // $encoded$d будет содержать строку "0J/RgNC40LLQtdGCIQ=="

codec.base64Decode(str string) ?string

<b>Назначение:</b> декодирует заданную в 
<a href="https://ru.wikipedia.org/wiki/%D0%A0%D0%B0%D1%81%D1%81%D1%82%D0%BE%D1%8F%D0%BD%D0%B8%D0%B5_%D0%94%D0%B0%D0%BC%D0%B5%D1%80%D0%B0%D1%83_%E2%80%94_%D0%9B%D0%B5%D0%B2%D0%B5%D0%BD%D1%88%D1%82%D0%B5%D0%B9%D0%BD%D0%B0" target="_blank">Base64</a> строку.

Аргументы:

1. str – строка, закодированная в Base64.

Возвращаемое значение: возвращает раскодированную строку либо nil, если закодированная строка содержит символы, не входящие в алфавит символов Base64 кодировки.

$decoded = codec.base64Decode("0J/RgNC40LLQtdGCIQ==") // $decoded будет содержать строку "Привет!"
$failed = codec.base64Decode("Привет!")               // $failed будет равен nil

codec.jsonEncode(value any) string

<b>Назначение:</b> кодирует заданное значение в <a href="https://ru.wikipedia.org/wiki/JSON" target="_blank">json</a>.

Аргументы:

1. value – произвольное значение для кодирования.

Возвращаемое значение: возвращает значение в формате json.

$encoded = codec.jsonEncode((1, true, "a", {"a": 1, "b": 2})) // $encoded будет содержать строку '[1, true, "a", {"a": 1, "b": 2}]'

codec.jsonDecode(value string) any

<b>Назначение:</b> декодирует заданное в 
<a href="https://ru.wikipedia.org/wiki/JSON" target="_blank">json</a> значение.

Аргументы:

1. value – значение, закодированное в json.

содержит 3600

dt.format(dt int|string, format string) string

Назначение: форматирует дату согласно заданному формату.

Аргументы:

• dt – дата, заданная строкой или числом секунд.
• format – строка, определяющая формат даты и времени.

Возвращаемое значение: строка даты в заданном формате.

Допустимые параметры форматирования:

Примечание: если строка формата содержит символы, совпадающие с вышеперечисленными, но не являющиеся параметрами форматирования, то их следует экранировать с помощью символа обратного слэша "\"Возвращаемое значение: возвращает раскодированное значение либо nil, в случае невозможности его раскодирования.

$decoded$dt = codecdt.jsonDecode('[1, true, "a", {"a": 1, "b": 2}]format('2022-12-20 08:34:05', 'y.MM.dd h-mm-ss')    // $dt будет содержать строку "22.12.20 8-34-05"
$dt = dt.format('16:30:47', '\Hour\s an\d \minute\s: HH/mm') // $decoded$dt будет содержать список [1, true, "a", {"a": 1, "b": 2}]

Функции для работы с датой и временем

dt.add(d1 int|string, d2 int|string) string

Назначение: складывает две даты, заданные в виде строки либо как число секунд.

• Если хотя бы один из аргументов функции число секунд, то это число будет прибавлено к числу секунд другой даты.
• Если обе даты заданы строкой, то результат определяется по формуле d1 + abs(secondsOf(d1) - secondsOf(d2)), где abs – модуль числа (положительное значение), secondsOf – это дата, представленная как количество секунд, прошедших с начала 1970 года (даты до этого времени представлены отрицательным значением). 

Аргументы:

1. d1 – строка, представляющая собой дату в одном из допустимых форматов, или целое число, соответствующее количеству секунд.
2. d2 – аналогично первому аргументу.

строку "Hours and minutes: 16/30"

dt.year(dt int|string) int

Назначение: возвращает полное числовое представление года, не менее 4 цифр.

Аргументы:

1. dt – дата, заданная строкой или числом секунд.

Возвращаемое значение: возвращает число, представляющее год аргумента даты dt.

Примечание: если в аргумент dt передано только время, то в качестве даты будет расцениваться 1 января 1970 года, и таким образом возвращаемое функцией значение будет равно 1970Возвращаемое значение: возвращает новую дату и время в виде строки.

$d$dt = dt.addyear("'2022-0112-0120 1208:30:00", 59)                    34:05') // $d$dt содержитбудет строку "2022-01-01 12:30:59" 
$d = dt.add(3600, "2022-01-01 12:30:00")                  // $d содержит строку "2022-01-01 13:30:00"
$d = dt.add("2022-01-02 02:00:00", "2022-01-01 01:00:00"содержать число 2022
$dt = dt.year('08:34:05') // $d$dt содержитбудет строку "2022-01-03 03:00:00"содержать число 1970

dt.

...

month(

...

dt int|string

...

) int

...

Назначение:вычисляет разность двух дат, заданных в виде строк либо количеством секунд.

• Если обе даты заданы количеством секунд, то функция вернёт их разность в виде числа секунд.
• Если обе даты заданы строкой, то будет возвращено целое число, равное разности между датами в секундах.
• Если первый аргумент задан строкой даты, а второй – числом секунд, то результатом будет новая дата, равная разности даты и числа секунд.
• Если второй аргумент задан строкой даты, а первый числом секунд, то результатом будет ошибка.

Аргументы:

1. d1 – строка, представляющая собой дату в одном из допустимых форматов, или целое число, соответствующее количеству секунд.
2. d2 – аналогично первому аргументу.

 возвращает порядковый номер месяца.

Аргументы:

1. dt – дата, заданная строкой или числом секунд.

Возвращаемое значение: возвращает число, представляющее месяц аргумента даты dt.

Примечание: если в аргумент dt передано только время, то в качестве даты будет расцениваться 1 января 1970 года, и таким образом возвращаемое функцией значение будет равно 1Возвращаемое значение: возвращает новую дату и время в виде строки либо число секунд – разность дат.

Блок кода
language php theme DJango firstline 1 title Примеры использования linenumbers true
$d$dt = dt.sub(100, 50) // $d содержит 50 $d = dt.sub("2022-01-01 12:30:00", 3600) // $d содержит строку "2022-01-01 11:30:00" $d = dt.sub(3600, "2022-01-01 12:30:00") // Такой вызов недопустим и приведёт к остановке программы $d = dt.sub("2022-01-01 01:00:00", "2022-01-01 00:00:00") // $d содержит 3600

dt.format(dt int|string, format string) string

month('2022-12-20 08:34:05') // $dt будет содержать число 12
$dt = dt.month('08:34:05') // $dt будет содержать число 1

dt.day(dt int|string) int

Назначение: возвращает день месяцаНазначение: форматирует дату согласно заданному формату.

Аргументы:

1. dt – дата, заданная строкой или числом секунд.

...

Возвращаемое значение:строка даты в заданном формате.

Допустимые параметры форматирования:

...

 возвращает число, представляющее день месяца аргумента даты dt.

Примечание: если в аргумент dt передано только время, то в качестве даты будет расцениваться 1 января 1970 года, и таким образом возвращаемое функцией значение будет равно 1.

$dt = dt.day('2022-12-20 08:34:05') // $dt будет содержать число 20
$dt = dt.day('08:34:05') // $dt будет содержать число 1

dt.hour(dt int|string) int

Назначение: возвращает часы в 24-часовом формате .

Аргументы:

1. dt – дата, заданная строкой или числом секунд.

Возвращаемое значение: возвращает число, представляющее часы аргумента даты dt.

Примечание: если в аргумент dt передана дата без времени, то возвращаемое значение будет равно нулю.

// Допустим сейчас 2023-01-01
$dt = dt.hour('2022-12-20 08:34:05') // $dt будет содержать число 8
$dt = dt.hour('2022-12-20') // $dt будет содержать число 0

dt.minute(dt int|string) int

Назначение: возвращает минуты.

Аргументы:

1. dt – дата, заданная строкой или числом секунд.

Возвращаемое значение: возвращает число, представляющее минуты аргумента даты dt.

Примечание: если в аргумент dt передана дата без времени, то возвращаемое значение будет равно нулюПримечание: если строка формата содержит символы, совпадающие с вышеперечисленными, но не являющиеся параметрами форматирования, то их следует экранировать с помощью символа обратного слэша "\".

// Допустим сейчас 2023-01-01
$dt = dt.formatminute('2022-12-20 08:34:05', 'y.MM.dd h-mm-ss')    // $dt будет содержать строку "22.12.20 8-34-05"число 34
$dt = dt.format('16:30:47', '\Hour\s an\d \minute\s: HH/mmminute('2022-12-20') // $dt будет содержать строку "Hours and minutes: 16/30"число 0

dt.

...

second(dt int|string) int

Назначение: возвращает полное числовое представление года, не менее 4 цифрсекунды.

Аргументы:

1. dt – дата, заданная строкой или числом секунд.

Возвращаемое значение: возвращает число, представляющее год секунды аргумента даты dt.

Примечание: если в аргумент dt передано только время, то в качестве даты будет расцениваться 1 января 1970 года, и таким образом возвращаемое функцией передана дата без времени, то возвращаемое значение будет равно 1970нулю.

// Допустим сейчас 2023-01-01
$dt = dt.yearsecond('2022-12-20 08:34:05') // $dt будет содержать число 20225
$dt = dt.yearsecond('08:34:052022-12-20') // $dt будет содержать число 19700

dt.

...

weekday(dt int|string) int

Назначение: возвращает порядковый номер месяцадня недели.

Аргументы:

1. dt – дата, заданная строкой или числом секунд.

Возвращаемое значение: возвращает число, представляющее месяц аргумента даты dtномер дня недели аргумента даты dt, от 0 (понедельник) до 6 (воскресенье).

Примечание: если в аргумент dt передано только время,  то то в качестве даты будет расцениваться 1 января 1970 года, и таким образом возвращаемое функцией значение будет равно 13 (четверг).

$dt = dt.monthweekday('2022-12-20 08:34:05') // $dt будет содержать число 121
$dt = dt.monthweekday('08:34:05') // $dt будет содержать число 13

...

date.nearFuture(day

...

int

...

) string

...

Назначение: возвращает день месяцаближайшую будущую к текущей дату по заданному дню.

Аргументы:

1. dt – дата, заданная строкой или числом секундday – число дней для определения ближайшей в будущем даты.

Возвращаемое значение: возвращает число, представляющее день месяца аргумента даты dt.Примечание: если в аргумент dt передано только время, то в качестве даты будет расцениваться 1 января 1970 года, и таким образом возвращаемое функцией значение будет равно 1ближайшую к day дату.

Блок кода
language php theme DJango firstline 1 title Примеры использования linenumbers true
$dt = dt.day('// Допустим сейчас 2022-12-20 08:34:05' $d = date.nearFuture(25) // $dt$d будет содержать число 20 $dtсодержит 2022-12-25 $d = dtdate.day('08:34:05'nearFuture(10) // $dt$d будет содержать число 1

...

содержит 2023-01-10

date.nearPast(day int) string

Назначение: возвращает часы в 24-часовом формате ближайшую прошлую к текущей дату по заданному дню.

Аргументы:

1. dt – дата, заданная строкой или числом секундday – число дней для определения ближайшей в прошлом даты.

Возвращаемое значение: возвращает число, представляющее часы аргумента даты dt.Примечание: если в аргумент dt передана дата без времени, то возвращаемое значение будет равно нулюближайшую к day дату.

// Допустим сейчас 20232022-0112-0120
$dt$d = dtdate.hour('2022-12-20 08:34:05'nearPast(25) // $dt$d будет содержать число 8
$dtсодержит 2022-11-25
$d = dtdate.hour('2022-12-20'nearPast(10) // $dt$d будет содержать число 0

...

содержит 2023-12-10

date.future(day int) string

Назначение: возвращает минутыдату, соответствующую указанному дню в следующем месяце.

Аргументы:

1. dt – дата, заданная строкой или числом секундday – число дней для определения даты в будущем.

Возвращаемое значение: возвращает число, представляющее минуты аргумента даты dt.Примечание: если в аргумент dt передана дата без времени, то возвращаемое значение будет равно нулюдата в будущем.

// Допустим сейчас 20232022-0112-0120
$dt$d = dtdate.minute('2022-12-20 08:34:05'future(25) // $dt$d будет содержать число 34
$dtсодержит 2023-01-25
$d = dtdate.minute('2022-12-20'future(10) // $dt$d будет содержать число 0

...

содержит 2023-01-10

date.past(day int) string

Назначение: возвращает секундыдату, соответствующую указанному дню в прошлом месяце.

Аргументы:

1. dt – дата, заданная строкой или числом секундday – число дней для определения даты в прошлом.

Возвращаемое значение: возвращает число, представляющее секунды аргумента даты dt.Примечание: если в аргумент dt передана дата без времени, то возвращаемое значение будет равно нулюдата в прошлом.

// Допустим сейчас 20232022-0112-0120
$dt$d = dtdate.second('2022-12-20 08:34:05'past(25) // $dt$d будет содержать число 5
$dtсодержит 2022-11-25
$d = dtdate.second('2022-12-20'past(10) // $dt$d будет содержать число 0

...

содержит 2022-11-10

time.nearFuture(minute int) string

Назначение: возвращает порядковый номер дня неделиближайшее будущее к текущему время по заданному количеству минут.

Аргументы:

1. dt – дата, заданная строкой или числом секундminute – число минут для определения ближайшего в будущем времени.

Возвращаемое значение: возвращает число, представляющее номер дня недели аргумента даты dt, от 0 (понедельник) до 6 (воскресенье).Примечание: если в аргумент dt передано только время, то в качестве даты будет расцениваться 1 января 1970 года, и таким образом возвращаемое функцией значение будет равно 3 (четверг)ближайшее к minute время.

$dt// Допустим сейчас 23:30:00
$t = dttime.weekday('2022-12-20 08:34:05'nearFuture(45) // $dt$t будет содержать число 1
$dtсодержит 23:45:00
$t = dttime.weekday('08:34:05'nearFuture(15) // $dt$t будет содержать число 3

...

содержит 00:15:00

time.nearPast(minute int) string

Назначение: возвращает ближайшую будущую к текущей дату ближайшее прошлое к текущему время по заданному днюколичеству минут.

Аргументы:

1. day minute – число дней минут для определения ближайшей ближайшего в будущем датыпрошлом времени.