Функции преобразования
Ниже приведены доступные функции преобразования.
| Функция | Описание |
|---|---|
| Base64Decode(Arg1) | Декодирует строку base64 в большой двоичный объект, который можно просматривать в Spotfire. Пример. Base64Decode([Column]) |
| Base64Encode(Arg1) | Кодирует большой двоичный объект в строку base64. Это может пригодиться, когда данные из Spotfire необходимо экспортировать в другие приложения. Пример. Base64Encode([Column]) |
| Boolean(Arg1) | Преобразует столбец или значение в тип Boolean.
Пример. Boolean([Column]) |
| Cast(Arg1 as type) | Приводит любое выражение к любому типу (кроме Null/Undefined). Недопустимые значения распространяются. Результат приведения разных типов входных и выходных данных отличается. Дополнительные сведения см. в разделе Метод Cast.
Пример. Cast([IntegerColumn] as Currency) |
| Currency(Arg1) | Преобразует столбец или значение в тип Currency.
Пример. Currency([Column]) |
| Date(Arg1, ..., Arg3) | Преобразует столбец или значения в тип Date. Если используется один аргумент, Arg1 может принадлежать к типу String или DateTime. Если указан тип String, дата должна быть записана в формате, который может распознать программа Spotfire. Кроме того, все части даты (год, месяц и день) должны присутствовать. См. приведенные далее примеры. Если указан тип DateTime, часть, которая обозначает время, удаляется. Если указаны три аргумента, они должны иметь значения типа Integer Первый аргумент — это год, второй — месяц, а третий — день месяца. Если дан один аргумент со значением Integer, функция Date интерпретирует этот аргумент Integer как тики. Отметки отсчитываются с интервалом 100 наносекунд, начиная с даты 01.01.01 (первое января первого года). См. также разделы Функции Date и Time и Метод Cast.
Примеры. Date("2003-03-21") → 3/21/2003 Date("3/21/03") → 3/21/2003 Date("10") → (Empty) Date(null) → (Empty) Date("2003-03-21 11:37:00") → 3/21/2003 Date(2003,03, 21) → 3/21/2003 Date(605000000000000000l) → 3/4/1918 (Доступные форматы вывода зависят от выбранной локали.) |
| DateTime(Arg1, Arg2,..., Arg7) | Преобразует столбец или значения в тип DateTime. Если используется один аргумент, Arg1 может принадлежать к типу String или Date. Если указан тип String, дата должна быть записана в формате, который может распознать программа Spotfire. Кроме того, должны присутствовать минимум все части даты (год, месяц и день). Если указан тип Date, задается время 00:00:00 (12:00:00). Если указаны семь аргументов, это должны быть значения, относящиеся к типу Integer. Первым аргументом является год, вторым — месяц, третьим — день месяца, четвертым — час, пятым — минута, шестым — секунда, а седьмым — миллисекунда. Если задан один аргумент Integer, функция DateTime интерпретирует это целое число как тики. Отметки отсчитываются с интервалом 100 наносекунд, начиная с даты 01.01.01 (первое января первого года). См. также разделы Функции Date и Time и Метод Cast.
Примеры. DateTime("2003-03-21 11:37:00") → 2003-03-21 11:37:00 DateTime("10") → (Empty) DateTime(null) → (Empty) DateTime("2003-03-21") → 2003-03-21 00:00:00 DateTime(2003, 03, 21, 11, 37, 00) → 2003-03-21 11:37:00 DateTime(605000000000000000l) → 04.03.1918 11:33:20 (Доступные форматы вывода зависят от выбранной локали.) |
| FirstValidAfter(Arg1) |
Заменяет отсутствующие значения в столбце первым допустимым значением после отсутствующего значения.
Пример. FirstValidAfter([Column]) |
| FromEpochMilliseconds(Arg1) |
Преобразует столбец или значение в дату и время, где цифры интерпретируются как количество миллисекунд, прошедших с 1 января 1970 г.
Пример. FromEpochMilliseconds(231312) |
| FromEpochSeconds(Arg1) |
Преобразует столбец или значение в дату и время, где цифры интерпретируются как количество секунд, прошедших с 1 января 1970 г.
Пример. FromEpochSeconds(231312) |
| Integer(Arg1) | Преобразует столбец или значение в число типа Integer. Если происходит сбой преобразования, возвращается ошибка. Arg1 может относиться к типу Integer, Real или String, а результат относится к типу Integer. Числа Real усекаются, то есть используется только целочисленная часть.
Примеры. Integer("-123") → -123 Integer(-2.99) → -2 Integer("0%") → (Empty) Integer(1e20) → (Empty) Integer(null) → (Empty) |
| LastValidBefore(Arg1) |
Заменяет отсутствующие значения в столбце последним допустимым значением перед отсутствующим значением.
Пример. LastValidBefore([Column]) |
| LongInteger(Arg1) | Преобразует столбец или значение в тип LongInteger.
Пример. LongInteger([Column]) |
| ParseDate(Arg1, ..., Arg3) | Анализирует дату из строки для получения формата Date. Первым аргументом является строка или строковый столбец, содержащие дату. Вторым аргументом является строка форматирования, в которой указано, как строится дата. А третьим (необязательным) аргументом является код региональных стандартов.
Примеры. ParseDate("2013-09-17", "yyyy-MM-dd") ParseDate("17-okt-2013","dd-MMM-yyyy","sv-SE") |
| ParseDateTime(Arg1, ..., Arg3) | Анализирует данные даты и времени из строки для получения формата DateTime. Первым аргументом является строка или строковый столбец, содержащие дату и время. Вторым аргументом является строка форматирования, в которой указано, как строится информация. А третьим (необязательным) аргументом является код региональных стандартов.
Примеры. ParseDateTime("2013-09-17 10:30", "yyyy-MM-dd h:mm") ParseDateTime("17-okt-2013 13:25","dd-MMM-yyyy HH:mm","sv-SE") |
| ParseReal(Arg1, Arg2) |
Анализирует строку для получения значения Real. Первый аргумент — строка или столбец строки. Второй (опциональный) аргумент — код культуры.
Примеры. ParseReal([Column], "en-US") ParseReal("7.25") |
| ParseTime(Arg1, ..., Arg3) | Анализирует время из строки для получения формата Time. Первым аргументом является строка или строковый столбец, содержащие время. Вторым аргументом является строка форматирования, в которой указано, как строится время. А третьим (необязательным) аргументом является код региональных стандартов.
Примеры. ParseTime("9:25", "h:mm") ParseTime("17:30", "HH:mm","sv-SE") |
| ParseTimeSpan(Arg1, ..., Arg3) |
Анализирует временной диапазон из строки для получения формата TimeSpan. Первый аргумент — строка или столбец строки с информацией о временном диапазоне. Вторым аргументом является строка форматирования, в которой указано, как строится информация. А третьим (необязательным) аргументом является код региональных стандартов.
Примеры. ParseTimeSpan("5.7:11:3.1", "d.h:m:s.f", "sv-SE") ParseTimeSpan("123 3 11 7 -5", "f s m h d") |
| Real(Arg1) | Преобразует столбец или значение в число Real. Если преобразование завершается неудачно, возвращается ошибка. Arg1 может относиться к типу Integer, Real или String, а результат относится к типу Real.
Примеры. Real(1.23) → 1,23 Real(2) → 2 Real("0%") → (Empty) Real(null) → (Empty) |
| SingleReal(Arg1) | Преобразует столбец или значение в тип SingleReal.
Пример. SingleReal([Column]) |
| SN(Arg1, Arg2) | Заменяет значения NULL. Возвращает Arg1, если этот аргумент не имеет значения NULL. В противном случае возвращает аргумент Arg2. Аргументы Arg1 и Arg2 могут относиться к любому типу, при этом оба должны относиться к одному и тому же типу или иметь значение NULL. Результат будет того же типа, что и эти аргументы. Обычно используется для замены значение NULL в столбце. Если аргумент Arg1 является столбцом, аргумент Arg2 может быть либо значением того же типа, что и содержимое столбца, либо столбцом с содержимым того же типа. Если столбцом является также аргумент Arg2, ошибка в аргументе Arg1 заменяется значением из той же строки в аргументе Arg2.
Примеры. SN(1, 2) → 1 SN(null, 2) → 2 SN(0/0, 2) → #NA SN([Column], 1) → 1 (при наличии в столбце значения NULL) SN([Column1], [Column2]) → (значение из Column2 при наличии значения NULL в столбце Column1) |
| String(Arg1) | Преобразует столбец или значение в тип String. Arg1 может принадлежать к любому типу, а результатом будет тип String. Прим.: Эта функция всегда использует форматирование значения по умолчанию. Это может привести к утрате точности при преобразовании числовых значений.
Примеры. String(1.23) →"1.23" String(null) → (Empty) |
| Time(Arg1, Arg2,..., Arg4) | Преобразует столбец или значения в тип Time. Если происходит сбой преобразования, возвращается ошибка. Если используется один аргумент, Arg1 может принадлежать к типу String или DateTime. Если задан тип String, время должно быть записано в формате, который может распознать программа Spotfire. Кроме того, должны быть указаны часы и минуты. См. приведенные далее примеры. Если указан тип DateTime, часть, которая обозначает дату, удаляется. Если указаны четыре аргумента, они должны быть значениями типа Integer. Первый аргумент — это час, второй — минута, третий — секунда, а четвертый — миллисекунда. Если задан один аргумент Integer, функция Time интерпретирует это целое число как тики. Отметки отсчитываются с интервалом 100 наносекунд, начиная с даты 01.01.01 (первое января первого года). См. также разделы Функции Date и Time и Метод Cast.
Примеры. Time("11:37:00") → 11:37:00 Time("10") → (Empty) Time(null) → (Empty) Time(11, 30, 20, 4) → 11:30:20 Time(605000000000000000l) → 11:33:20 (Доступные форматы вывода зависят от выбранной локали.) |
| TimeSpan(Arg1, Arg2,...,Arg5)) | Создает значение TimeSpan из столбца или значений. Если задан один аргумент, входной столбец может относиться к типу String или TimeSpan. Если указан тип String, временной диапазон (TimeSpan) необходимо записать в формате «[-]д.ч:м:с.мс». Если указаны пять аргументов, то первым аргументом являются дни, вторым — часы, третьим — минуты, четвертым — секунды, а пятым — миллисекунды. Первые четыре аргумента относятся к типу Integers, а последний представляет собой число Real.
Примеры. TimeSpan([Column]) TimeSpan("247.5:17:11.5002") TimeSpan(247, 05, 17, 11, 500.2) |
| ToEpochMilliseconds([Arg1]) |
Преобразовывает столбец или значение из даты и времени в число, соответствующее количеству миллисекунд, которые прошли с 1 января 1970 г.
Пример. ToEpochMilliseconds([Date]) |
| ToEpochSeconds([Arg1]) |
Преобразовывает столбец или значение из даты и времени в число, соответствующее количеству секунд, которые прошли с 1 января 1970 г.
Пример. ToEpochSeconds([Date]) |
Список типов данных, доступных для преобразования, см. в разделе Типы данных.
Также см. раздел Функции.