Функции типов и форматирования

В данном разделе при описании функций приняты следующие обозначения:

  • Типы значений, которые принимает аргумент, указаны в угловых скобках.

  • Перечень необязательных аргументов заключается в квадратные скобки. При вызове функции квадратные скобки вводить не нужно.

  • После :: в угловых скобках указаны типы значений, которые возвращает функция.

Функции проверки типов

is_null

Проверяет, является ли значение value пустым (null) или нет.

Для более гибкой проверки используйте функцию is_nullish.

Спецификация функции

is_null(value: <любой тип>)
:: <логическое значение>
Аргумент Тип Описание По умолчанию Обязателен

value

любой

Значение, которое необходимо проверить

да

Примеры

Значение null

Пример 1. Исходный код
is_null(null)
Пример 2. Результат
true

Несоответствующий тип

Пример 3. Исходный код
is_null("строка")
Пример 4. Результат
false

is_nullish

Определяет, является ли value "nullish", то есть не имеющим значимого содержания. "Nullish" считаются значения:

  • null;

  • "-";

  • состоящие только из пробелов, то есть символов со свойством Unicode White_Space.

Спецификация функции

is_nullish(value: <любой тип>)
:: <логическое значение>
Аргумент Тип Описание По умолчанию Обязателен

value

любой

Значение, которое необходимо проверить на отсутствие значимого содержания

да

Примеры

Обнаружение null (пустая строка)

Пример 5. Исходный код
is_nullish("")
Пример 6. Результат
true

Обнаружение null (строка с дефисом)

Пример 7. Исходный код
is_nullish("-")
Пример 8. Результат
true

Обнаружение null (пустая строка)

Пример 9. Исходный код
is_nullish("


")
Пример 10. Результат
true

is_empty

Проверяет, имеет ли объект, массив или строка нулевую длину.

Спецификация функции

is_empty(value: <объект | массив | строка>)
:: <логическое значение>
Аргумент Тип Описание По умолчанию Обязателен

value

объект массив строка

Значение, которое необходимо проверить.

да

Примеры

Пустой массив

Пример 11. Исходный код
is_empty([])
Пример 12. Результат
true

Непустая строка

Пример 13. Исходный код
is_empty("строка")
Пример 14. Результат
false

Непустой объект

Пример 15. Исходный код
is_empty({"foo": "bar"})
Пример 16. Результат
false

is_boolean

Проверяет, является ли value логическим значением.

Спецификация функции

is_boolean(value: <любой тип>)
:: <логическое значение>
Аргумент Тип Описание По умолчанию Обязателен

value

любое

Значение, которое необходимо проверить

да

Примеры

Допустимое логическое значение

Пример 17. Исходный код
is_boolean(false)
Пример 18. Результат
true

Несоответствующий тип

Пример 19. Исходный код
is_boolean("строка")
Пример 20. Результат
false

is_integer

Проверяет, является ли value целым числом.

Спецификация функции

is_integer(value: <любой тип>)
:: <логическое значение>
Аргумент Тип Описание По умолчанию Обязателен

value

любой

Значение, которое необходимо проверить.

да

Примеры

Допустимое целое число

Пример 21. Исходный код
is_integer(1)
Пример 22. Результат
true

Несоответствующий тип

Пример 23. Исходный код
is_integer("строка")
Пример 24. Результат
false

is_float

Проверяет, является ли value числом с плавающей точкой.

Спецификация функции

is_float(value: <любой тип>)
:: <логическое значение>
Аргумент Тип Описание По умолчанию Обязателен

value

любой

Значение, которое необходимо проверить.

да

Примеры

Допустимое число с плавающей точкой

Пример 25. Исходный код
is_float(0.577)
Пример 26. Результат
true

Несоответствующий тип

Пример 27. Исходный код
is_float("строка")
Пример 28. Результат
false

is_timestamp

Проверяет, является ли value меткой времени (timestamp).

Спецификация функции

is_timestamp(value: <любой тип>)
:: <логическое значение>
Аргумент Тип Описание По умолчанию Обязателен

value

любой

Значение, которое необходимо проверить.

да

Примеры

Допустимая метка времени (timestamp)

Пример 29. Исходный код
is_timestamp(t'2021-03-26T16:00:00Z')
Пример 30. Результат
true

Несоответствующий тип

Пример 31. Исходный код
is_timestamp("строка")
Пример 32. Результат
false

is_string

Проверяет, является ли value строкой.

Спецификация функции

is_string(value: <любой тип>)
:: <логическое значение>
Аргумент Тип Описание По умолчанию Обязателен

value

любой

Значение, которое необходимо проверить

да

Примеры

Допустимая строка

Пример 33. Исходный код
is_string("строка")
Пример 34. Результат
true

Несоответствующий тип

Пример 35. Исходный код
is_string([1, 2, 3])
Пример 36. Результат
false

rv_is_utf8

Проверяет, является ли value строкой, закодированной в UTF-8.

Спецификация функции

rv_is_utf8(value: <любой тип>)
:: <логическое значение>
Аргумент Тип Описание По умолчанию Обязателен

value

любой

Значение, которое необходимо проверить

да

Примеры

Допустимая строка

Пример 37. Исходный код
rv_is_utf8("valid_string")
Пример 38. Результат
true

Недопустимая строка

Пример 39. Исходный код
rv_is_utf8(b"\xff123123")
Пример 40. Результат
false

Не строка

Пример 41. Исходный код
rv_is_utf8(123)
Пример 42. Результат
false

is_ipv4

Проверяет, является ли value допустимым IPv4-адресом или нет.

IPv4-совместимые и IPv4-преобразованные IPv6-адреса не считаются допустимыми.

Спецификация функции

is_ipv4(value: <строка>)
:: <логическое значение>
Аргумент Тип Описание По умолчанию Обязателен

value

строка

IP-адрес, который необходимо проверить.

да

Примеры

Допустимый IPv4-адрес

Пример 43. Исходный код
is_ipv4("10.0.102.37")
Пример 44. Результат
true

Допустимый IPv6-адрес

Пример 45. Исходный код
is_ipv4("2001:0db8:85a3:0000:0000:8a2e:0370:7334")
Пример 46. Результат
false

Произвольная строка

Пример 47. Исходный код
is_ipv4("foobar")
Пример 48. Результат
false

is_ipv6

Проверяет, является ли value допустимым IPv6-адресом или нет.

Спецификация функции

is_ipv6(value: <строка>)
:: <логическое значение>
Аргумент Тип Описание По умолчанию Обязателен

value

строка

IP-адрес, который необходимо проверить.

да

Примеры

Допустимый IPv6-адрес

Пример 49. Исходный код
is_ipv6("2001:0db8:85a3:0000:0000:8a2e:0370:7334")
Пример 50. Результат
true

Допустимый IPv4-адрес

Пример 51. Исходный код
is_ipv6("10.0.102.37")
Пример 52. Результат
false

Произвольная строка

Пример 53. Исходный код
is_ipv6("foobar")
Пример 54. Результат
false

is_json

Проверяет, является ли value допустимым документом JSON.

Спецификация функции

is_json(value: <строка>, [variant: <строка>])
:: <логическое значение>
Аргумент Тип Описание По умолчанию Обязателен

value

строка

Значение, которое необходимо проверить

да

variant

строка

Вариант типа JSON для явной проверки:

  • object — объект JSON;

  • array — массив JSON;

  • string — строковое значение в формате JSON, заключенное в кавычки;

  • number — целое число или число с плавающей запятой;

  • bool — true или false;

  • null — значение null.

нет

Примеры

Допустимый JSON-объект

Пример 55. Исходный код
is_json("{}")
Пример 56. Результат
true

Недопустимое значение

Пример 57. Исходный код
is_json("{")
Пример 58. Результат
false

Точный вариант

Пример 59. Исходный код
is_json("{}", variant: "object")
Пример 60. Результат
true

Недопустимый точный вариант

Пример 61. Исходный код
is_json("{}", variant: "array")
Пример 62. Результат
false

is_regex

Проверяет, является ли value регулярным выражением.

Спецификация функции

is_regex(value: <любой тип>)
:: <логическое значение>
Аргумент Тип Описание По умолчанию Обязателен

value

любой

Значение, которое необходимо проверить

да

Примеры

Допустимое регулярное выражение

Пример 63. Исходный код
is_regex(r'pattern')
Пример 64. Результат
true

Несоответствующий тип

Пример 65. Исходный код
is_regex("строка")
Пример 66. Результат
false

is_array

Проверяет, является ли value массивом.

Спецификация функции

is_array(value: <любой тип>)
:: <логическое значение>
Аргумент Тип Описание По умолчанию Обязателен

value

любой

Значение, которое необходимо проверить

да

Примеры

Допустимый массив

Пример 67. Исходный код
is_array([1, 2, 3])
Пример 68. Результат
true

Несоответствующий тип

Пример 69. Исходный код
is_array("строка")
Пример 70. Результат
false

is_object

Проверяет, является ли value объектом.

Спецификация функции

is_object(value: <любой тип>)
:: <логическое значение>
Аргумент Тип Описание По умолчанию Обязателен

value

любой

Значение, которое необходимо проверить

да

Примеры

Допустимый объект

Пример 71. Исходный код
is_object({"foo": "bar"})
Пример 72. Результат
true

Несоответствующий тип

Пример 73. Исходный код
is_object("строка")
Пример 74. Результат
false

tag_types_externally

Добавляет информацию о типе ко всем вложенным скалярным значениям в предоставленном значении value.

Информация о типе добавляется в ключ, то есть после преобразования value имеет форму объекта с полями "тип": значение.

Спецификация функции

tag_types_externally(value: <любой тип>)
:: <объект | массив объектов | пустое значение>
Аргумент Тип Описание По умолчанию Обязателен

value

любое

Значение, которое нужно пометить типами.

да

Примеры

Пометить тип в скалярном значении

Пример 75. Исходный код
tag_types_externally(123)
Пример 76. Результат
{
  "integer": 123
}

Пометить типы в объекте

Пример 77. Исходный код
tag_types_externally({
  "message": "Hello world",
  "request": {
    "duration_ms": 67.9
  }
})
Пример 78. Результат
{
  "message": {
    "string": "Hello world"
  },
  "request": {
    "duration_ms": {
      "float": 67.9
    }
  }
}

Пометить типы в массиве

Пример 79. Исходный код
tag_types_externally(["foo", "bar"])
Пример 80. Результат
[
  {
    "string": "foo"
  },
  {
    "string": "bar"
  }
]

Типы в пустом значении

Пример 81. Исходный код
tag_types_externally(null)
Пример 82. Результат
null

Функции валидации типов

bool

Возвращает value, если это логическое значение, иначе возвращает ошибку. Это позволяет проверяющему типу гарантировать, что возвращаемое значение является логическим и может быть использовано в любой функции, которая ожидает логическое значение.

Спецификация функции

bool(value: <любой тип>)
:: <логическое значение>, <ошибка>
Аргумент Тип Описание По умолчанию Обязателен

value

любое

Значение, которое необходимо проверить на принадлежность к логическим.

да

Ошибки

Функция bool возвращает ошибку, для которой требуется обработка, если value не является логическим значением.

Пример

Объявление типа Boolean

Пример 83. Исходный код
bool!(.value)
Пример 84. Результат
false

int

Возвращает value, если оно является целым числом, иначе возвращает ошибку. Это позволяет проверке типов гарантировать, что возвращаемое значение является целым числом и может быть использовано в любой функции, ожидающей такой тип данных.

Спецификация функции

int(value: <любой тип>)
:: <целое число>, <ошибка>
Аргумент Тип Описание По умолчанию Обязателен

value

любой

Значение, для которого необходимо убедиться, что оно является целым числом.

да

Ошибки

Функция int возвращает ошибку, для которой требуется обработка, если value не является целым числом.

Пример

Объявление переменной типа целое число

Пример 85. Исходный код
int!(.value)
Пример 86. Результат
42

float

Возвращает value, если это число с плавающей точкой, и ошибки в противном случае. Это позволяет средству проверки типов гарантировать, что возвращаемое значение является числом с плавающей точкой и может использоваться в любой функции, которая его ожидает.

Спецификация функции

float(value: <лобое>)
:: <число с плавающей точкой>, <ошибка>
Аргумент Тип Описание По умолчанию Обязателен

value

любое

Значение, которое необходимо проверить на тип float.

да

Ошибки

Функция float возвращает ошибку, для которой требуется обработка, если value не является числом с плавающей точкой.

Пример

Объявление типа float

Пример 87. Исходный код
float!(.value)
Пример 88. Результат
42

timestamp

Возвращает value, если это метка времени, иначе возвращает ошибку. Это позволяет проверке типов гарантировать, что возвращенное значение является меткой времени и может быть использовано в любой функции, которая ожидает метку времени.

Спецификация функции

timestamp(value: <любой тип>)
:: <метка времени>, <ошибка>
Аргумент Тип Описание По умолчанию Обязателен

value

любое

Значение, которое нужно обеспечить меткой времени.

да

Ошибки

Функция timestamp возвращает ошибку, для которой требуется обработка, если value не является меткой времени.

Пример

Объявление типа метки времени

Пример 89. Исходный код
ok, err = timestamp(.timestamp)
Пример 90. Результат
function call error for "timestamp" at (10:31): expected timestamp, got string

string

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

Спецификация функции

string(value: <любой тип>)
:: <строка>, <ошибка>
Аргумент Тип Описание По умолчанию Обязателен

value

любое

Значение, для которого нужно гарантировать тип строки.

да

Ошибки

Функция string возвращает ошибку, для которой требуется обработка, если value не является строкой.

Пример

Объявление типа строки

Пример 91. Исходный код
string!(.message)
Пример 92. Результат
"{\"поле\": \"значение\"}"

array

Возвращает value, если оно является массивом, иначе возвращает ошибку. Это позволяет проверить тип и гарантирует, что возвращаемое значение — это массив, который может быть использован в любой функции, ожидающей массив.

Спецификация функции

array(value: <любой тип>)
:: <массив>, <ошибка>
Аргумент Тип Описание По умолчанию Обязателен

value

любое

Значение, проверяемое на предмет того, является ли оно массивом.

да

Ошибки

Функция array возвращает ошибку, для которой требуется обработка, если value не является массивом.

Пример

Объявление массива

Пример 93. Исходный код
array!(.value)
Пример 94. Результат
[
  1,
  2,
  3
]

object

Возвращает value, если оно является объектом, иначе возвращает ошибку. Это позволяет проверить, что возвращаемое значение является объектом и может быть использовано в любой функции, ожидающей объект.

Спецификация функции

object(value: <любой тип>)
:: <объект>, <ошибка>
Аргумент Тип Описание По умолчанию Обязателен

value

любое

Значение, которое требуется проверить

да

Ошибки

Функция object возвращает ошибку, для которой требуется обработка, если value не является объектом.

Пример

Определение типа объекта

Пример 95. Исходный код
object!(.value)
Пример 96. Результат
{
  "field1": "value1",
  "field2": "value2"
}

Функции представлений чисел

format_number

Форматирует value в строковое представление числа.

Спецификация функции

format_number(value: <целое число | число с плавающей точкой>, [scale: <целое число>, decimal_separator: <строка>, grouping_separator: <строка>])
:: <строка>
Аргумент Тип Описание По умолчанию Обязателен

value

целое число число с плавающей точкой

Число для форматирования в строку.

да

scale

целое число

Количество десятичных знаков для отображения.

нет

decimal_separator

строка

Символ, используемый между целой и десятичной частями числа.

.

нет

grouping_separator

строка

Символ, используемый между каждой тысячной частью числа.

,

нет

Пример

Форматирование числа с тремя десятичными знаками

Пример 97. Исходный код
format_number(1234567.89, 3, decimal_separator: ".", grouping_separator: ",")
Пример 98. Результат
"1,234,567.890"

format_int

Форматирует целое число value в строковое представление с использованием заданного основания.

Спецификация функции

format_int(value: <целое число>, [base: <целое число>])
:: <строка>, <ошибка>
Аргумент Тип Описание По умолчанию Обязателен

value

целое число

Число для форматирования.

да

base

целое число

Основание для форматирования числа. Должно быть между 2 и 36 включительно.

10

нет

Ошибки

Функция format_int возвращает ошибку, для которой требуется обработка, если основание не находится между 2 и 36.

Примеры

Форматирование как шестнадцатеричное число

Пример 99. Исходный код
format_int!(42, 16)
Пример 100. Результат
"2a"

Форматирование как отрицательное шестнадцатеричное число

Пример 101. Исходный код
format_int!(-42, 16)
Пример 102. Результат
"-2a"

parse_int

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

Спецификация функции

parse_int(value: <строка>, [base: <целое число>])
:: <целое число>, <ошибка>
Аргумент Тип Описание По умолчанию Обязателен

value

строка

Строка для разбора.

да

base

целое число

Система счисления числа. Должна быть в диапазоне от 2 до 36 включительно.

Если не указано, для определения системы счисления будет использоваться префикс строки:

  • 0b — двоичная;

  • 0, 0o — восьмеричная;

  • 0x — шестнадцатеричная;

  • в остальных случаях — десятеричная.

нет

Ошибки

Функция parse_int может возвращать ошибки, для которых требуется обработка:

  • Значение base не находится в диапазоне от 2 до 36;

  • Число не может быть разобрано в указанной системе счисления.

Примеры

Разбор десятичного числа

Пример 103. Исходный код
parse_int!("-42")
Пример 104. Результат
-42

Разбор двоичного числа

Пример 105. Исходный код
parse_int!("0b1001")
Пример 106. Результат
9

Разбор восьмеричного числа

Пример 107. Исходный код
parse_int!("0o42")
Пример 108. Результат
34

Разбор шестнадцатеричного числа

Пример 109. Исходный код
parse_int!("0x2a")
Пример 110. Результат
42

Разбор числа с явно указанной системой счисления

Пример 111. Исходный код
parse_int!("2a", 17)
Пример 112. Результат
44

parse_float

Разбирает строку value, представляющую число в десятичной системе счисления, в число с плавающей точкой.

Спецификация функции

parse_float(value: <строка>)
:: <число с плавающей точкой>, <ошибка>
Аргумент Тип Описание По умолчанию Обязателен

value

строка

Строка для разбора.

да

Ошибки

Функция parse_float может возвращать ошибки, для которых требуется обработка:

  • value не может быть разобрано как число.

  • Значение NaN не поддерживается.

Примеры

Разбор отрицательного числа

Пример 113. Исходный код
parse_float!("-42")
Пример 114. Результат
-42.0

Разбор числа с плавающей запятой

Пример 115. Исходный код
parse_float!("42.38")
Пример 116. Результат
42.38

Разбор экспоненциальной записи

Пример 117. Исходный код
parse_float!("2.5e3")
Пример 118. Результат
2500.0

to_int

Приводит value к целому числу.

Спецификация функции

to_int(value: <целое число | число с плавающей точкой | логическое значение | строка | метка времени>)
:: <целое число>, <ошибка>
Аргумент Тип Описание По умолчанию Обязателен

value

целое число число с плавающей точкой логическое значение строка метка времени

Значение для преобразования в целое число.

да

Характеристики функции

Поведение функции зависит от типа value:

  • При преобразовании чисел с плавающей точкой отбрасывается дробная часть.

  • При преобразовании логических значений true преобразуется в 1, false в 0.

  • Строки преобразуются, только если состоят из десятичных чисел и знаков.

  • Метки времени преобразуются в формат времени Unix.

Ошибки

Функция to_int может возвращать ошибки, для которых требуется обработка:

  • value является строкой, но текст не является целым числом

  • value не является строкой, числом или меткой времени

Примеры

Приведение строки к целому числу

Пример 119. Исходный код
to_int!("-02")
Пример 120. Результат
2

Приведение метки времени к целому числу

Пример 121. Исходный код
to_int(t'2020-12-30T22:20:53.824727Z')
Пример 122. Результат
1609366853

Приведение числа с плавающей точкой к целому числу

Пример 123. Исходный код
to_int(2.6)
Пример 124. Результат
2

to_float

Приводит value к типу с плавающей точкой.

Спецификация функции

to_float(value: <целое число | число с плавающей точкой | логическое значение | строка | метка времени>)
:: <число с плавающей точкой>, <ошибка>
Аргумент Тип Описание По умолчанию Обязателен

value

целое число число с плавающей точкой логическое значение строка метка времени

Значение для преобразования в число с плавающей точкой. Должно быть преобразуемым в число с плавающей точкой, иначе будет сгенерирована ошибка.

да

Характеристики функции

Поведение функции зависит от типа value:

  • При преобразовании логических значений true принимает значение 1,false-- 0.

  • Строки преобразуются, только если состоят из десятичных чисел, знаков и десятичной точки.

  • Метки времени преобразуются в формат времени Unix с указанием наносекунд.

Ошибки

Функция to_float может возвращать ошибки, для которых требуется обработка:

  • value не является поддерживаемым представлением числа с плавающей точкой.

  • value, представленное меткой времени, находится вне допустимого диапазона для меток времени.

Примеры

Приведение к числу с плавающей точкой

Пример 125. Исходный код
to_float!("3.145")
Пример 126. Результат
3.145

Приведение метки времени к числу с плавающей точкой

Пример 127. Исходный код
to_float(t'2020-12-30T22:20:53.824727Z')
Пример 128. Результат
1609366853.824727

Приведение строки к числу с плавающей точкой

Пример 129. Исходный код
to_float!(".5")
Пример 130. Результат
0.5

Функции преобразования чисел

abs

Вычисляет модуль числа value.

Спецификация функции

abs(value: <целое число | число с плавающей точкой>)
:: <целое число | число с плавающей точкой>
Аргумент Тип Описание По умолчанию Обязателен

value

целое число число с плавающей точкой

Число для вычисления модуля.

да

Примеры

Вычисление модуля целого числа

Пример 131. Исходный код
abs(-42)
Пример 132. Результат
42

Вычисление модуля числа с плавающей точкой

Пример 133. Исходный код
abs(-42.2)
Пример 134. Результат
42.2

ceil

Округляет value к большему до указанной точности precision.

Спецификация функции

ceil(value: <целое число | число с плавающей точкой>, [precision: <целое число>])
:: <целое число | число с плавающей точкой>
Аргумент Тип Описание По умолчанию Обязателен

value

целое число число с плавающей точкой

Число, которое нужно округлить вверх.

да

precision

целое число

Количество десятичных знаков для округления.

0

нет

Примеры

Округление числа к большему без указания точности

Пример 135. Исходный код
ceil(4.345)
Пример 136. Результат
5

Округление числа к большему с указанием точности

Пример 137. Исходный код
ceil(4.345, precision: 2)
Пример 138. Результат
4.35

floor

Округляет value вниз до указанной precision (точности).

Спецификация функции

floor(value: <целое число | число с плавающей точкой>, [precision: <целое число>])
:: <целое число | число с плавающей точкой>
Аргумент Тип Описание По умолчанию Обязателен

value

целое число число с плавающей точкой

Число, которое нужно округлить вниз.

да

precision

целое число

Количество десятичных знаков для округления.

0

нет

Примеры

Округление числа вниз без указания точности

Пример 139. Исходный код
floor(4.345)
Пример 140. Результат
4

Округление числа вниз с указанием точности

Пример 141. Исходный код
floor(4.345, precision: 2)
Пример 142. Результат
4.34

round

Округляет value до указанной точности precision.

Спецификация функции

round(value: <целое число | число с плавающей точкой>, [precision: <целое число>])
:: <целое число | число с плавающей точкой>
Аргумент Тип Описание По умолчанию Обязателен

value

целое число число с плавающей точкой

Число для округления.

да

precision

целое число

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

0

нет

Примеры

Округление числа без указания точности

Пример 143. Исходный код
round(4.345)
Пример 144. Результат
4

Округление числа с указанием точности

Пример 145. Исходный код
round(4.345, precision: 2)
Пример 146. Результат
4.35

mod

Вычисляет остаток от деления value на modulus.

Спецификация функции

mod(value: <целое число | число с плавающей точкой>, modulus: <целое число | число с плавающей точкой>)
:: <целое число | число с плавающей точкой>, <ошибка>
Аргумент Тип Описание По умолчанию Обязателен

value

целое число число с плавающей точкой

Значение, для которого применяется деление по модулю.

да

modulus

целое число число с плавающей точкой

Значение модуля.

да

Ошибки

Функция mod может возвращать ошибки, для которых требуется обработка:

  • value не является целым числом или числом с плавающей точкой.

  • modulus не является целым числом или числом с плавающей точкой.

  • modulus равен 0.

Пример

Вычисление остатка от деления двух целых чисел

Пример 147. Исходный код
remainder = mod(5, 2)
Пример 148. Результат
1

Функции форматирования меток времени

from_unix_timestamp

Преобразует целое число value из формата времени Unix в формат времени VRL (timestamp).

Преобразует из количества секунд с начала эпохи Unix по умолчанию, но также можно указать миллисекунды или наносекунды с помощью параметра unit.

Спецификация функции

from_unix_timestamp(value: <целое число>, [unit: <строка>])
:: <метка времени>
Аргумент Тип Описание По умолчанию Обязателен

value

целое число

Целое число Unix-времени для преобразования

да

unit

строка

Единица измерения времени:

  • seconds;

  • milliseconds;

  • microseconds;

  • nanoseconds.

seconds

нет

Ошибки

Функция from_unix_timestamp может возвращать ошибки, для которых требуется обработка:

  • value не является целым числом.

  • В аргументе unit указана неизвестная единица.

Примеры

Преобразование из формата Unix-времени (секунды)

Пример 149. Исходный код
from_unix_timestamp!(5)
Пример 150. Результат
1970-01-01T00:00:05Z

Преобразование из формата Unix-времени (миллисекунды)

Пример 151. Исходный код
from_unix_timestamp!(5000, unit: "milliseconds")
Пример 152. Результат
1970-01-01T00:00:05Z

Преобразование из формата Unix-времени (наносекунды)

Пример 153. Исходный код
from_unix_timestamp!(5000, unit: "nanoseconds")
Пример 154. Результат
1970-01-01T00:00:00.000005Z

to_unix_timestamp

Преобразует значение метки времени (value) в метку времени Unix.

По умолчанию возвращает количество секунд с момента начала эпохи Unix, но можно также указать миллисекунды микросекунды или наносекунды в аргументе unit.

Спецификация функции

to_unix_timestamp(value: <метка времени>, [unit: <строка>])
:: <целое число>
Аргумент Тип Описание По умолчанию Обязателен

value

метка времени

Метка времени для преобразования в Unix.

да

unit

строка

Единица измерения времени:

  • seconds;

  • milliseconds;

  • microseconds;

  • nanoseconds.

seconds

нет

Ошибки

Функция to_unix_timestamp может возвращать ошибки, для которых требуется обработка:

  • value вне допустимого диапазона для меток времени.

  • В аргументе unit указана неизвестная единица.

Примеры

Преобразование в метку времени Unix (секунды)

Пример 155. Исходный код
to_unix_timestamp(t'2021-01-01T00:00:00+00:00')
Пример 156. Результат
1609459200

Преобразование в метку времени Unix (миллисекунды)

Пример 157. Исходный код
to_unix_timestamp(t'2021-01-01T00:00:00Z', unit: "milliseconds")
Пример 158. Результат
1609459200000

Преобразование в метку времени Unix (наносекунды)

Пример 159. Исходный код
to_unix_timestamp(t'2021-01-01T00:00:00Z', unit: "nanoseconds")
Пример 160. Результат
1609459200000000000

format_timestamp

Форматирует value в строковое представление времени.

Спецификация функции

format_timestamp(value: <метка времени>, format: <строка>, [timezone: <строка>])
:: <строка>
Аргумент Тип Описание По умолчанию Обязателен

value

метка времени

Метка времени для форматирования в текст.

да

format

строка

Строка формата, описанная в библиотеке Chrono.

да

timezone

строка

Часовой пояс, используемый при форматировании метки времени. Используйте идентификатор TZ или 'local'.

нет

Примеры

Форматирование метки времени согласно ISO8601/RFC 3339

Пример 161. Исходный код
format_timestamp!(t'2020-10-21T16:00:00Z', format: "%+")
Пример 162. Результат
"2020-10-21T16:00:00+00:00"

Форматирование метки времени (пользовательский формат)

Пример 163. Исходный код
format_timestamp!(t'2020-10-21T16:00:00Z', format: "%v %R")
Пример 164. Результат
"21-Oct-2020 16:00"

parse_timestamp

Разбирает value в формате strptime.

По умолчанию функция использует системный часовой пояс для разбора меток времени. Для анализа временных меток без указания часового пояса, таких как 16/10/2019 12:00:00, можно использовать аргумент `timezone`.

Спецификация функции

parse_timestamp(value: <строка>, format: <строка>, [timezone: <строка>])
:: <метка времени>, <ошибка>
Аргумент Тип Описание Обязателен

value

строка

Текст времени.

да

format

строка

Формат strptime.

да

timezone

строка

Часовой пояс в формате tz database.

нет

Ошибки

Функция parse_timestamp может возвращать ошибки, для которых требуется обработка:

  • value не удалось разобрать с использованием предоставленного format;

  • value не удалось разобрать с использованием предоставленного timezone.

Примеры

Разбор метки времени

Пример 165. Исходный код
parse_timestamp!("10-Oct-2020 16:00+00:00", format: "%v %R %:z")
Пример 166. Результат
2020-10-10T16:00:00Z

Разбор метки времени с указанием часового пояса

Пример 167. Исходный код
parse_timestamp!("16/10/2019 12:00:00", format: "%d/%m/%Y %H:%M:%S", timezone: "Asia/Taipei")
Пример 168. Результат
2019-10-16T04:00:00Z

Функции приведения строк и логических значений

to_bool

Приводит value к логическому значению.

Спецификация функции

to_bool(value: <логическое значение | целое число | число с плавающей точкой | пустое значение | строка>)
:: <логическое значение>, <ошибка>
Аргумент Тип Описание По умолчанию Обязателен

value

логическое значение целое число число с плавающей точкой пустое значение строка

Значение для преобразования в логическое значение.

да

Ошибки

Функция to_bool возвращает ошибку, для которой требуется обработка, если value не является поддерживаемым представлением логического значения.

Примеры

Приведение строки к логическому значению

Пример 169. Исходный код
to_bool!("yes")
Пример 170. Результат
true

Приведение числа с плавающей точкой к логическому значению

Пример 171. Исходный код
to_bool(0.0)
Пример 172. Результат
false

Приведение целого числа к логическому значению

Пример 173. Исходный код
to_bool(0)
Пример 174. Результат
false

Приведение null к логическому значению

Пример 175. Исходный код
to_bool(null)
Пример 176. Результат
false

to_regex

Приводит value к регулярному выражению.

Компиляция регулярного выражения — это ресурсозатратная операция и может ограничивать пропускную способность Vector. Используйте эту функцию, только если вы уверены, что в задаче невозможно обойтись без нее.

Спецификация функции

to_regex(value: <строка>)
:: <регулярное выражение>, <ошибка>
Аргумент Тип Описание По умолчанию Обязателен

value

строка

Значение для преобразования в регулярное выражение

да

Ошибки

Функция to_regex возвращает ошибку, для которой требуется обработка, если value не является строкой.

Пример

Приведение к регулярному выражению

Пример 177. Исходный код
to_regex("^foo$") ?? r''
Пример 178. Результат
^foo$

to_string

Приводит value к строке.

Спецификация функции

to_string(value: < целое число | число с плавающей точкой | логическое значение | строка | метка времени>)
:: <число с плавающей точкой | пустое значение>)
:: <строка>, <ошибка>
Аргумент Тип Описание По умолчанию Обязателен

value

целое число число с плавающей точкой логическое значение строка метка времени пустое значение

Значение для преобразования в строку

да

Ошибки

Функция to_string возвращает ошибку, для которой требуется обработка, если value не является целым числом, числом с плавающей точкой, логическим значением, строкой, меткой времени или пустым значением.

Примеры

Приведение логического значения к строке

Пример 179. Исходный код
to_string(true)
Пример 180. Результат
"true"

Приведение целого числа к строке

Пример 181. Исходный код
to_string(52)
Пример 182. Результат
"52"

Приведение числа с плавающей точкой к строке

Пример 183. Исходный код
to_string(52.2)
Пример 184. Результат
"52.2"

Была ли полезна эта страница?

+7 (499) 755 55 70 sales@rvision.ru

О компании Пользовательское соглашение Политика cookies

Обратная связь