Функція TEXT

Матеріал з Planfix
Перейти до: навігація, пошук

За допомогою функції TEXT() можна змінити представлення числа або дати, застосувавши форматування.

Форматування чисел

Функція TEXT() форматує число відповідно до заданого формату. Наприклад, якщо в стовпці A знаходиться число 23,7825 і його необхідно відформатувати до трьох знаків після коми:

TEXT(A;".3f")

В результаті отримується рядок "23,783".


Формат:

TEXT(число;рядок_формату)


Рядок формату:

Рядок формату має вигляд [flags][width][.precision]conversion

  • [flags] — спеціальні символи для форматування. Наприклад, прапорець "+" означає, що числове значення повинно включати знак +, прапорець "-" означає вирівнювання результату по лівому краю, прапорець «,» встановлює роздільник тисяч у цілих числах. Не є обов'язковою частиною інструкції.
  • [width] — додатне ціле десяткове число, яке визначає мінімальну кількість символів, які будуть виведені. Не є обов'язковою частиною інструкції.
  • [.precision] — невід'ємне ціле десяткове число з крапкою перед ним. Зазвичай використовується для обмеження кількості символів. Не є обов'язковою частиною інструкції.
  • conversion — це символ, який вказує, як число повинно бути відформатовано. Допускається d для цілих чисел, f для чисел з плаваючою точкою. Є обов'язковою частиною інструкції.

Наприклад, у полі типу Число записано число 12.34:

  • TEXT({{Task.Field type number}};"d") - результат 12
  • TEXT({{Task.Field type number}};"05d") - результат 00012
  • TEXT({{Task.Field type number}};"08.3f") - результат 0012.340
  • TEXT({{Task.Field type number}};".4f") - результат 12.3400


Приклади:

TEXT(A;".3f")

TEXT({{Task.Field type number}};".3f")

TEXT(1234567; ",.2f") - результат: 12 345,67


Форматування дат

Таблиця з формулами для форматування дат. Розглянуто приклад форматування дати: 12.10.2016.

Що відобразити Як Формат Формула Результат
Місяці 1-12 "M" TEXT(A;"M") 10
Місяці 01-12 "MM" TEXT(A;"MM") 10
Місяці січ-гру "MMМ" TEXT(A;"MMM") жов
Місяці Січень-Грудень "MMМM" TEXT(A;"MMMМ") Жовтень
Місяці С-Г "MMМMM" TEXT(A;"MMMМM") Ж
Дні 1-31 "D" TEXT(A;"D") 12
Дні 01-31 "DD" TEXT(A;"DD") 12
Дні Пн-Нд "DDD" TEXT(A;"DDD") Ср
Дні понеділок-неділя "DDDD" TEXT(A;"DDDD") середа
Роки 00-99 "YY" TEXT(A;"YY") 16
Роки 1900-9999 "YYYY" TEXT(A;"YYYY") 2016


Щоб функція відмінювала місяць у родовому відмінку, використовуйте наступний синтаксис:

TEXT(Число; "[$-FCxx]Формат дати")

де:

xx — це мова:

  • 19 — російська
  • 22 — українська

Приклад:

ТЕКСТ({{System.Today}}; "[$-FC19]DD MMMM YYYY")

Результат:

14 червня 2022


Форматування значення часу

Таблиця з формулами для форматування значення часу. Розглянуто приклад форматування часу: 14:22:44.

Що відобразити Як Формат Формула Результат
Години 0-23 "H" TEXT(A;"H") 14
Години 00-23 "HH" TEXT(A;"HH") 14
Хвилини 0-59 "m" TEXT(A;"m") 22
Хвилини 00-59 "mm" TEXT(A;"mm") 22
Секунди 0-59 "s" TEXT(A;"s") 44
Секунди 00-59 "ss" TEXT(A;"ss") 44
Час 14:00 "HH:00" TEXT(A;"HH:00") 14:00
Час 14:22 "HH:mm" TEXT(A;"HH:mm") 14:22
Час 14:22:44 "HH:mm:ss" TEXT(A;"HH:mm:ss") 14:22:44
Час 14:22:44,11 "гг:хх:сс,00" TEXT(A;"HH:mm:ss,00") 14:22:44,11
Затрачений час (годин і хвилин) 1:02 "[H]:mm" TEXT(A;"[H]:mm") 1:02
Затрачений час (хвилин і секунд) 62:16 "[mm]:ss" TEXT(A;"[mm]:ss") 62:16
Затрачений час (секунд і сотих часток) 3735,80 "[ss],00" TEXT(A;"[ss],00") 3735,80


Важливо

  • Час і Дата розділяються пробілом обов'язково.
  • Час розділяється знаком ":" і "," для мілісекунд 23:15:41,456.
  • Дата розділяється одним з символів "." "/" "-".
  • Якщо не вказана дата, то замість неї буде 01.01.1900.
  • Рядок формату для дат досить гнучкий (вводимо будь-який рядок і в ньому заміняться певні символи на одиниці часу). Спеціальні символи — D,M,Y,H,m,s — необхідно екранувати, щоб відобразити як літеру, а не час.
  • Можна виводити тривалість в годинах/хвилинах/секундах (якщо вказана тільки дата, то виведеться кількість часу з 31.12.1899, тобто тривалість в годинах для 01.01.1900 = 24).
  • Рік з двох цифр вважається як рік 21 століття.
  • Якщо в рядку формату потрібен зворотний слеш "\" , то його необхідно екранувати — "\\". Це особливо важливо, якщо він в кінці рядка.
  • Якщо формат закінчується на d/f і при цьому потрібна дата, необхідно екранувати d/f. Наприклад, TEXT("12.05.2018"; "\Hello worl\d") отримаємо в полі таке значення: Hello world.


Перейти