Если задуматься, все, что выводится в отчет, в конце концов – текст. Функция ToText, как ясно из ее названия и приводит все к текстовому формату. Эта функция является специфичной для Crystal Reports. Она имеет аж пять форм:
ToText (x)
ToText (x, y)
ToText (x,y,z)
ToText (x,y,z,w)
ToText (x,y,z,w,q)
Преобразование булевых значений:
- x – булево значение. Возвращается “True” или “False”.
Преобразование десятичных чисел и денежных значений:
- x – десятичное число или денежное значение.
- y – число, определяющее количество десятичных знаков дробной части (необязательный аргумент).
- z – символ, используемый в качестве разделителя тысяч (необязательный аргумент). По умолчанию используется символ из Региональных установок Windows.
- w – символ, используемый в качестве десятичного разделителя (необязательный аргумент). По умолчанию используется символ из Региональных установок Windows.
Преобразование десятичных чисел и денежных значений (с форматированием):
- x – десятичное число или денежное значение.
- y – строка форматирования.
- z – число, определяющее количество десятичных знаков дробной части (необязательный аргумент).
- w – символ, используемый в качестве разделителя тысяч (необязательный аргумент). По умолчанию используется символ из Региональных установок Windows.
- q – символ, используемый в качестве десятичного разделителя (необязательный аргумент). По умолчанию используется символ из Региональных установок Windows.
Преобразование значений даты:
- x – значение даты.
- y – строка форматирования.
Преобразование значений времени:
- x – значение времени.
- y – строка форматирования.
- z – символ, используемый в качестве метки А.М. (утренних часов). (необязательный параметр)
- w - символ, используемый в качестве метки Р.М. (вечерних часов). (необязательный параметр)
Преобразование значений даты/времени:
- x – значение времени.
- y – строка форматирования.
- z – символ, используемый в качестве метки А.М. (утренних часов). (необязательный параметр)
- w - символ, используемый в качестве метки Р.М. (вечерних часов). (необязательный параметр)
Примеры:
ToText(123.45)
Возвращает "123.45".
ToText(12345.6749,2)
Возвращает "12345.67".
ToText(12345.6750,2)
Возвращает "12345.68".
ToText(12345.4999,0)
Возвращает "12345".
ToText(12345.5000,0)
Возвращает "12346".