|
Администрирование Oracle CRM On Demand > Expression Builder > Функции инструмента Expression Builder > ToChar
ToChar
Функция ToChar в инструменте Expression Builder служит для преобразования заданной даты или числового выражения в отформатированную строку.
Синтаксис
ToChar(expression, format)
ВНИМАНИЕ! Не используйте одновременно формат даты и числовой формат в экземпляре функции ToChar, поскольку это может привести к неверным результатам.
Тип результата
Строка
Аргументы
В следующей таблице приведено описание аргументов функции.
Аргумент
|
Описание
|
Выражение
|
Выражение или поле, возвращающее дату, дату и время или числовое значение.
|
Формат
|
Строка, представляющая формат даты или числа.
|
В следующей таблице приведено описание форматов дат для данной функции.
Формат кода.
|
Описание
|
DD
|
День месяца из двух цифр (01 - 31)
|
DDDD
dddd
|
Название дня.
|
MM
|
Номер месяца из двух цифр (01-12, где 01 соответствует ЯНВ). Необходимо использовать заглавные буквы ММ, поскольку mm обозначают минуты.
|
MMMM
MMMM
|
Название месяца. Имейте в виду, что при использовании строчных букв необходимо использовать четыре буквы "m" ("mmmm"), поскольку две такие буквы ("mm") обозначают минуты.
|
Y
|
Последняя цифра года.
|
YY
|
Последние две цифры года.
|
YYYY
|
Четыре цифры года.
|
hh12
|
Час дня в 12-часовом формате.
|
hh24
|
Час дня в 24-часовом формате.
|
hh
|
Час дня. Можно указать половину суток (AM/PM) для 12-часового формата, например:
hh:mm:ss PM
Если половина суток не указана, по умолчанию используется 24-часовой формат.
|
mm
|
Минуты. Следует отметить, что "mm" (то есть две строчных буквы "m") всегда обозначают минуты и не могут использоваться для обозначения двух цифр дня месяца.
|
ss
|
Секунды.
|
В следующей таблице приведено описание форматов чисел для данной функции.
Формат кода.
|
Пример
|
Описание
|
#
|
####
|
Возвращаемое значение содержит заданное количество цифр; отрицательное значение начинается со знака "минус".
|
0
|
####.00
|
Возвращаются начальные нули. Возвращаются конечные нули.
|
$
|
$###.00
|
Возвращаемое значение начинается со знака доллара США.
|
,
|
#,###
|
Возвращаемое значение содержит запятую в заданной позиции. Запятая не может находиться справа от десятичной точки. Шаблон формата не может начинаться с запятой.
|
.
|
###.##
|
Возвращаемое значение содержит десятичную точку в заданной позиции. В параметре format допускается только одна десятичная точка. Если заданное количество позиций после десятичной точки меньше количества цифр в дробной части, десятичное значение округляется вверх.
|
Примеры использования числовых форматов
В следующем примере возвращается значение 10:
ToChar (10, '##.##')
В следующем примере возвращается значение 10:
ToChar (10, '##.00')
В следующем примере возвращается значение 10.24:
ToChar (10.2388, '##.00')
В следующем примере возвращается значение -10.24:
ToChar (-10.2388, '##.##')
Примеры использования форматов даты
В следующем примере значение, возвращаемой функцией Timestamp(), преобразуется в формат ДД/ММ/ГГГГ:
ToChar(Timestamp(),"DD/MM/YYYY")
Например, если функция Timestamp() возвращает значение 02/29/2008 10:58:37, результатом вычисления предыдущего выражения является 29/02/2008.
В следующих примерах показано отображение двенадцати часов ночи в различных форматах:
ToChar(Today(), YYYY/MM/DD hh:mm:ss PM) возвращает 2009/05/22 12:00:00 AM
ToChar(Today(), YYYY/MM/DD hh:mm:ss) возвращает 2009/05/22 00:00:00
ToChar(Today(), YYYY/MM/DD hh24:mm:ss PM) возвращает 2009/05/22 00:00:00
Связанные темы
Информацию об инструменте Expression Builder, связанную с данной темой, см. в следующих разделах.
| 
