Функція TEXT: відмінності між версіями

Матеріал з Planfix
Перейти до: навігація, пошук
Немає опису редагування
Немає опису редагування
 
Рядок 1: Рядок 1:
{{#seo:
{{#seo:
|title=Функція TEXT
|title=Функція ТЕКСТ
|titlemode=append
|titlemode=append
|keywords=planfix, Функція, TEXT, звіти
|keywords=planfix, Функція, ТЕКСТ, звіти
|description=Функція TEXT
|description=Функція ТЕКСТ
}}
}}
За допомогою функції TEXT() можна змінити представлення числа або дати, застосувавши форматування.
За допомогою функції ТЕКСТ() можна змінити подання числа або дати, застосувавши форматування.


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


TEXT(A;".3f")
ТЕКСТ(A;".3f")


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




Формат:
Формат:
'''ТЕКСТ(число;рядок_формату)'''


'''TEXT(число;рядок_формату)'''
'''TEXT(число;рядок_формату)'''
Рядок 23: Рядок 25:


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


Наприклад, у полі типу '''Число''' записано число 12.34:   
Наприклад, у полі типу '''Число''' записане число 12.34:   
*TEXT(<nowiki>{{Task.Field type number}}</nowiki>;"d") - результат 12
*ТЕКСТ(<nowiki>{{Задача.Поле типа число}}</nowiki>;"d") - результат 12
*TEXT(<nowiki>{{Task.Field type number}}</nowiki>;"05d") - результат 00012
*ТЕКСТ(<nowiki>{{Задача.Поле типа число}}</nowiki>;"05d") - результат 00012
*TEXT(<nowiki>{{Task.Field type number}}</nowiki>;"08.3f") - результат 0012.340
*ТЕКСТ(<nowiki>{{Задача.Поле типа число}}</nowiki>;"08.3f") - результат 0012.340
*TEXT(<nowiki>{{Task.Field type number}}</nowiki>;".4f") - результат 12.3400
*ТЕКСТ(<nowiki>{{Задача.Поле типа число}}</nowiki>;".4f") - результат 12.3400




'''Приклади:'''
'''Приклади:'''


TEXT(A;".3f")
ТЕКСТ(A;".3f")


TEXT(<nowiki>{{Task.Field type number}}</nowiki>;".3f")
ТЕКСТ(<nowiki>{{Задача.Поле типа число}}</nowiki>;".3f")


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




Рядок 58: Рядок 60:
|1-12
|1-12
|"M"
|"M"
|TEXT(A;"M")
|ТЕКСТ(A;"M")
|10
|10
|-
|-
Рядок 64: Рядок 66:
|01-12
|01-12
|"MM"
|"MM"
|TEXT(A;"MM")
|ТЕКСТ(A;"MM")
|10
|10
|-
|-
Рядок 70: Рядок 72:
|січ-гру
|січ-гру
|"MMМ"
|"MMМ"
|TEXT(A;"MMM")
|ТЕКСТ(A;"MMM")
|жов
|жов
|-
|-
Рядок 76: Рядок 78:
|Січень-Грудень
|Січень-Грудень
|"MMМM"
|"MMМM"
|TEXT(A;"MMMМ")
|ТЕКСТ(A;"MMMМ")
|Жовтень
|Жовтень
|-
|-
|Місяці
|Місяці
|С-Г
|О-Ґ (одна літера)
|"MMМMM"
|"MMМMM"
|TEXT(A;"MMMМM")
|ТЕКСТ(A;"MMMМM")
|-
|-
Рядок 88: Рядок 90:
|1-31
|1-31
|"D"
|"D"
|TEXT(A;"D")
|ТЕКСТ(A;"D")
|12
|12
|-
|-
Рядок 94: Рядок 96:
|01-31
|01-31
|"DD"
|"DD"
|TEXT(A;"DD")
|ТЕКСТ(A;"DD")
|12
|12
|-
|-
Рядок 100: Рядок 102:
|Пн-Нд
|Пн-Нд
|"DDD"
|"DDD"
|TEXT(A;"DDD")
|ТЕКСТ(A;"DDD")
|Ср
|Ср
|-
|-
Рядок 106: Рядок 108:
|понеділок-неділя
|понеділок-неділя
|"DDDD"
|"DDDD"
|TEXT(A;"DDDD")
|ТЕКСТ(A;"DDDD")
|середа
|середа
|-
|-
Рядок 112: Рядок 114:
|00-99
|00-99
|"YY"
|"YY"
|TEXT(A;"YY")
|ТЕКСТ(A;"YY")
|16
|16
|-
|-
Рядок 118: Рядок 120:
|1900-9999
|1900-9999
|"YYYY"
|"YYYY"
|TEXT(A;"YYYY")
|ТЕКСТ(A;"YYYY")
|2016
|2016
|}
|}




Щоб функція відмінювала місяць у родовому відмінку, використовуйте наступний синтаксис:
Щоб функція відмінила відмінок місяця в родовому відмінку, використовуйте наступний синтаксис:
  TEXT(Число; "[$-FCxx]Формат дати")
  ТЕКСТ(Число; "[$-xxx]Формат дати")


де:
де:


xx — це мова:
xxx — це мова:
:*19 — російська
:*FC19 — російська
:*22 — українська
:*FC22 — українська
:*409 — англійська


Приклад:
Приклад:


  <nowiki>ТЕКСТ({{System.Today}}; "[$-FC19]DD MMMM YYYY")</nowiki>
  <nowiki>ТЕКСТ({{Системные.Сегодня}}; "[$-FC19]DD MMMM YYYY")</nowiki>


Результат:
Результат:


  14 червня 2022
  14 июня 2022
 


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


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


{| class="wikitable" style="text-align: center;"
{| class="wikitable" style="text-align: center;"
Рядок 155: Рядок 157:
|0-23
|0-23
|"H"
|"H"
|TEXT(A;"H")
|ТЕКСТ(A;"H")
|14
|14
|-
|-
Рядок 161: Рядок 163:
|00-23
|00-23
|"HH"
|"HH"
|TEXT(A;"HH")
|ТЕКСТ(A;"HH")
|14
|14
|-
|-
Рядок 167: Рядок 169:
|0-59
|0-59
|"m"
|"m"
|TEXT(A;"m")
|ТЕКСТ(A;"m")
|22
|22
|-
|-
Рядок 173: Рядок 175:
|00-59
|00-59
|"mm"
|"mm"
|TEXT(A;"mm")
|ТЕКСТ(A;"mm")
|22
|22
|-
|-
Рядок 179: Рядок 181:
|0-59
|0-59
|"s"
|"s"
|TEXT(A;"s")
|ТЕКСТ(A;"s")
|44
|44
|-
|-
Рядок 185: Рядок 187:
|00-59
|00-59
|"ss"
|"ss"
|TEXT(A;"ss")
|ТЕКСТ(A;"ss")
|44
|44
|-
|-
Рядок 191: Рядок 193:
|14:00
|14:00
|"HH:00"
|"HH:00"
|TEXT(A;"HH:00")
|ТЕКСТ(A;"HH:00")
|14:00
|14:00
|-
|-
Рядок 197: Рядок 199:
|14:22
|14:22
|"HH:mm"
|"HH:mm"
|TEXT(A;"HH:mm")
|ТЕКСТ(A;"HH:mm")
|14:22
|14:22
|-
|-
Рядок 203: Рядок 205:
|14:22:44
|14:22:44
|"HH:mm:ss"
|"HH:mm:ss"
|TEXT(A;"HH:mm:ss")
|ТЕКСТ(A;"HH:mm:ss")
|14:22:44
|14:22:44
|-
|-
|Час
|Час
|14:22:44,11
|14:22:44,11
|"гг:хх:сс,00"
|"чч:мм:сс,00"
|TEXT(A;"HH:mm:ss,00")
|ТЕКСТ(A;"HH:mm:ss,00")
|14:22:44,11
|14:22:44,11
|-
|-
|Затрачений час (годин і хвилин)
|Витрачений час (години і хвилини)
|1:02
|1:02
|"[H]:mm"
|"[H]:mm"
|TEXT(A;"[H]:mm")
|ТЕКСТ(A;"[H]:mm")
|1:02
|1:02
|-
|-
|Затрачений час (хвилин і секунд)
|Витрачений час (хвилини і секунди)
|62:16
|62:16
|"[mm]:ss"
|"[mm]:ss"
|TEXT(A;"[mm]:ss")
|ТЕКСТ(A;"[mm]:ss")
|62:16
|62:16
|-
|-
|Затрачений час (секунд і сотих часток)
|Витрачений час (секунди і соті частки)
|3735,80
|3735,80
|"[ss],00"
|"[ss],00"
|TEXT(A;"[ss],00")
|ТЕКСТ(A;"[ss],00")
|3735,80
|3735,80
|}
|}
Рядок 233: Рядок 235:


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




== Перейти ==
== Перейти ==
*[[Функції]]
*[[Стандартные функции| Формулы]]
*[[Обчислювані поля]]
*[[Обчислювані поля]]
*[[Звіти]]
*[[Звіти]]

Поточна версія на 12:57, 23 листопада 2025

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

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

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

ТЕКСТ(A;".3f")

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


Формат:

ТЕКСТ(число;рядок_формату)

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


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

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

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

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

  • ТЕКСТ({{Задача.Поле типа число}};"d") - результат 12
  • ТЕКСТ({{Задача.Поле типа число}};"05d") - результат 00012
  • ТЕКСТ({{Задача.Поле типа число}};"08.3f") - результат 0012.340
  • ТЕКСТ({{Задача.Поле типа число}};".4f") - результат 12.3400


Приклади:

ТЕКСТ(A;".3f")

ТЕКСТ({{Задача.Поле типа число}};".3f")

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


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

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

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


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

ТЕКСТ(Число; "[$-xxx]Формат дати")

де:

xxx — це мова:

  • FC19 — російська
  • FC22 — українська
  • 409 — англійська

Приклад:

ТЕКСТ({{Системные.Сегодня}}; "[$-FC19]DD MMMM YYYY")

Результат:

14 июня 2022

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

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

Що відобразити Як Формат Формула Результат
Години 0-23 "H" ТЕКСТ(A;"H") 14
Години 00-23 "HH" ТЕКСТ(A;"HH") 14
Хвилини 0-59 "m" ТЕКСТ(A;"m") 22
Хвилини 00-59 "mm" ТЕКСТ(A;"mm") 22
Секунди 0-59 "s" ТЕКСТ(A;"s") 44
Секунди 00-59 "ss" ТЕКСТ(A;"ss") 44
Час 14:00 "HH:00" ТЕКСТ(A;"HH:00") 14:00
Час 14:22 "HH:mm" ТЕКСТ(A;"HH:mm") 14:22
Час 14:22:44 "HH:mm:ss" ТЕКСТ(A;"HH:mm:ss") 14:22:44
Час 14:22:44,11 "чч:мм:сс,00" ТЕКСТ(A;"HH:mm:ss,00") 14:22:44,11
Витрачений час (години і хвилини) 1:02 "[H]:mm" ТЕКСТ(A;"[H]:mm") 1:02
Витрачений час (хвилини і секунди) 62:16 "[mm]:ss" ТЕКСТ(A;"[mm]:ss") 62:16
Витрачений час (секунди і соті частки) 3735,80 "[ss],00" ТЕКСТ(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. Наприклад, ТЕКСТ("12.05.2018"; "\Hello worl\d") отримаємо в полі таке значення: Hello world.


Перейти