Если задуматься, все, что выводится в отчет, в конце концов – текст. Функция 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".