FormatDate - Revision history

Admin: 1 revision imported

2024-06-14T10:40:19Z

1 revision imported

1>Admin at 09:50, 23 May 2024

2024-05-23T09:50:11Z

Admin: 1 revision imported

2021-04-16T14:17:41Z

1 revision imported

1>Admin at 09:31, 13 March 2021

2021-03-13T09:31:50Z

Admin: 1 revision imported

2021-02-07T06:51:00Z

1 revision imported

Admin at 08:44, 13 December 2020

2020-12-13T08:44:17Z

New page

{{infobox function
|name=FormatDate
|caption=Функции работы со строками, датами
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, дату
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Строковые функции]], [[Функции работы с датами]]}}
Функция производит перекодировку даты и времени в строковой формат по указанному шаблону, используя указанный язык.

== Синтаксис ==
<code>
'''FormatDate'''(''<Дата>'',''<Шаблон форматирования>''{{Optional|,''<Язык форматирования (STRING)>''}}):''<Результат (STRING)>''
</code>
==== Аргументы ====
* <code>''<Дата>''</code> - Дата, которую необходимо преобразовать в строковой формат.
* <code>''<Шаблон форматирования>''</code> - Строковое представление используется как текстовый шаблон для форматирования результата. В шаблоне могут присутствовать любые символы, однако, определенные комбинации символов будут превращены при форматировании в части исходной даты, все остальные символы, не принадлежащие заданным заранее комбинациям, будут скопированы в результат без изменения. Каждая комбинация состоит из заранее определенного числа символов или любого числа символов, см. ниже. Шаблон может включать следующие комбинации символов:

{|class="wikitable sortable" style="border-collapse:collapse;font-size:80%;width=95%;"
! width=10%|Комбинация символов
! width=5%|Изменяемая длина
! Описание
|-
|-align="left"
|'''d''' или '''D'''
|Да
|Подставляет числовое значение дня месяца даты. Количество символов определяет минимальную длину результата, результат дополняется ведущими нулями. К примеру <code>D</code> возвращает числа 1, 2, 12 и пр., <code>DD</code> возвращает числа 01, 02, 12 и пр., <code>DDD</code> возвращает числа 001, 002, 012 и пр.
|-align="left"
|'''n'''
|Да
|Подставляет числовое значение номера дня недели даты. Первым днем недели является понедельник. Количество символов определяет минимальную длину результата, результат дополняется ведущими нулями. К примеру <code>n</code> возвращает числа 1, 2, 3, <code>nn</code> возвращает числа 01, 02, 03.
|-align="left"
|'''N'''
|
|Подставляет три первых буквы наименования дня недели даты. Первым днем недели является понедельник. Для русского шаблона будут подставлены следующие значения: Пнд, Втр, Срд, Чтв, Пят, Суб, Вск. Для английского шаблона будут подставлены следующие значения: Mon, Tue, Wed, Thu, Fri, Sat, Sun.
|-align="left"
|'''NN'''
|
|Подставляет полное наименование дня недели даты. Первым днем недели является понедельник. Для русского шаблона будут подставлены следующие значения: Понедельник, Вторник, Среда, Четверг, Пятница, Суббота, Воскресенье. Для английского шаблона будут подставлены следующие значения: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.
|-align="left"
|'''m'''
|Да
|Подставляет числовое значение номера месяца даты. Количество символов определяет минимальную длину результата, результат дополняется ведущими нулями. К примеру <code>m</code> возвращает числа 1, 2, 11, <code>mm</code> возвращает числа 01, 02, 11.
|-align="left"
|'''M'''
|
|Подставляет три первых буквы наименования месяца даты. Для русского шаблона будут подставлены следующие значения: Янв, Фев, Мар, Апр, Май, Июн, Июл, Авг, Сен, Окт, Ноя, Дек. Для английского шаблона будут подставлены следующие значения: Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec.
|-align="left"
|'''MM'''
|
|Подставляет полное наименование месяца даты. Для русского шаблона будут подставлены следующие значения: Январь, Февраль, Март, Апрель, Май, Июнь, Июль, Август, Сентябрь, Октябрь, Ноябрь, Декабрь. Для английского шаблона будут подставлены следующие значения: January, February, March, April, May, June, July, August, September, October, November, December.
|-align="left"
|'''MMM'''
|
|Подставляет полное наименование месяца даты в родительном падеже (когда применимо). Для русского шаблона будут подставлены следующие значения: Января, Февраля, Марта, Апреля, Мая, Июня, Июля, Августа, Сентября, Октября, Ноября, Декабря. Для английского шаблона будут подставлены следующие значения: January, February, March, April, May, June, July, August, September, October, November, December.
|-align="left"
|'''Y'''
|Да
|Подставляет числовое значение года даты. Количество символов определяет минимальную длину результата, результат дополняется ведущими нулями. Употребительно к году, обычная запись выглядит, как <code>YYYY</code>.
|-align="left"
|'''y'''
|Да
|Подставляет числовое значение года даты, год записан двумя последними числами (2021 записывается, как 21). Количество символов определяет минимальную длину результата, результат дополняется ведущими нулями. Употребительно к году, обычная запись выглядит, как <code>yy</code>.
|-align="left"
|'''q''' или '''Q'''
|Да
|Подставляет числовое значение номера квартала даты. Количество символов определяет минимальную длину результата, результат дополняется ведущими нулями. К примеру <code>q</code> возвращает числа 1, 2, 3, <code>qq</code> возвращает числа 01, 02, 03.
|-align="left"
|'''o''' или '''O'''
|Да
|Подставляет числовое значение номера дня года даты. Количество символов определяет минимальную длину результата, результат дополняется ведущими нулями. К примеру <code>o</code> возвращает числа 1, 2, 123, <code>oo</code> возвращает числа 01, 02, 123.
|-align="left"
|'''w''' или '''W'''
|Да
|Подставляет числовое значение номера недели в году. Количество символов определяет минимальную длину результата, результат дополняется ведущими нулями. К примеру <code>w</code> возвращает числа 1, 2, 3, <code>ww</code> возвращает числа 01, 02, 03. Первой неделей года считается неделя, в которую входит 1 января данного года. Последние числа года могут входить в последнюю неделю года, также как и в первую неделю следующего года, они могут иметь двоякое представление. Данная функция будет относить их к последней неделе уходящего года. Пример день ''31.12.2018'' принадлежит 53 неделе 2018 года и 1 неделе 2019 года, данная функция будет отдавать 53 употребительно к дате ''31.12.2018'' и 1 употребительно к дате ''01.01.2019''.
|-align="left"
|'''h'''
|Да
|Подставляет числовое значение часа даты. Количество символов определяет минимальную длину результата, результат дополняется ведущими нулями. К примеру <code>h</code> возвращает числа 1, 2, 12, <code>hh</code> возвращает числа 01, 02, 12. Используется 24-часовой формат.
|-align="left"
|'''H''' или '''HH'''
|
|Подставляет числовое значение часа даты. Количество символов определяет минимальную длину результата, результат дополняется ведущими нулями. К примеру <code>H</code> возвращает числа 1, 2, 11, <code>HH</code> возвращает числа 01, 02, 11. Используется 12-часовой формат.
|-align="left"
|'''HHH''' или '''HHHH'''
|
|Подставляет числовое значение часа даты с символами интервала (вариант 1). Используется 12-часовой формат. Количество символов определяет минимальную длину результата, результат дополняется ведущими нулями. К примеру <code>HHH</code> возвращает числа 1 AM, 2 PM, 11 AM, <code>HHHH</code> возвращает числа 01 AM, 02 PM, 11 AM.
|-align="left"
|'''HHHНН''' или '''HHHННH'''
|
|Подставляет числовое значение часа даты с символами интервала (вариант 2). Используется 12-часовой формат. Количество символов определяет минимальную длину результата, результат дополняется ведущими нулями. К примеру <code>HHHНН</code> возвращает числа 1 a.m., 2 p.m., 11 a.m., <code>HННHHH</code> возвращает числа 01 a.m., 02 p.m., 11 a.m..
|-align="left"
|'''t''' или '''T'''
|Да
|Подставляет числовое значение минуты даты. Количество символов определяет минимальную длину результата, результат дополняется ведущими нулями. К примеру <code>t</code> возвращает числа 1, 2, 11, <code>tt</code> возвращает числа 01, 02, 11.
|-align="left"
|'''s''' или '''S'''
|Да
|Подставляет числовое значение секунды даты. Количество символов определяет минимальную длину результата, результат дополняется ведущими нулями. К примеру <code>s</code> возвращает числа 1, 2, 11, <code>ss</code> возвращает числа 01, 02, 11.
|-align="left"
|'''p''' или '''P'''
|Да
|Подставляет числовое значение миллисекунды даты. Количество символов определяет минимальную длину результата, результат дополняется нулями с конца строки. Минимальное количество цифр всегда равно трем. К примеру <code>p</code> возвращает числа 001, 012, 211, <code>pppp</code> возвращает числа 0010, 0120, 2110.
|-align="left"
|'''""'''
|
|Превращается в символ <code>"</code>
|-align="left"
|'''"<выражение>"'''
|Да
|Выражение внутри двойных кавычек подставляется в результат без изменения. Таким образом можно использовать знаки, которые приводили бы к подставлению частей даты. Пример: <code>DD "of" MM YYYY</code> позволяет получить в результате слово ''of'' вместо номера дня года.
|}

* <code>''<Язык форматирования (STRING)>''</code> - {{Optional}} Две буквы языка форматирования в латинской нотации. По умолчанию используется язык сборки или язык, заданный функцией [[SelectLanguage]]. Словарь перевода задан в файлах профайла, находящихся в подпапке '''Profiles''' папки клиента. Файлы имеют формат UTF-16 с [[BOM]]. Файлы должны иметь наименование <code>Common.<язык>.sfs</code>. Т.е., для словая русского языка используется файл '''Common.ru.sfs''', английского '''Common.en.sfs'''. Файл словаря содержит кроме слов, связанных с превращением в текстовый формат даты и времени, также слова для создания прописи из чисел, прописи наименований валют и пр.

==== Возвращаемое значение ====
Функция всегда возвращает строку UTF-16.

== Примеры ==
<pre>
Message(FormatDate('12.10.2015 12:00:05',"DD ""of"" MM YYYY, HHHHH tt:ss","en"));
//Будет выведено "12 of October 2015, 12 p.m. 00:05"

Message(FormatDate('12.10.2015 12:00:05',"DD MMM YYYY г., hh:tt:ss.ppp","ru"));
//Будет выведено "12 Октября 2015 г., 12:00:05.000"

Message(FormatDate('12.10.2015 12:00:05',"dd.mm.yy"));
//Будет выведено "12.10.15"

Message(FormatDate('12.10.2015 12:00:05',"YYYYmmdd"));
//Будет выведено "20151012"
</pre>

← Older revision	Revision as of 10:40, 14 June 2024
(No difference)

@@ Line 15: / Line 15: @@
 == Синтаксис ==
 <code>
-'''FormatDate'''(''<Дата>'',''<Шаблон форматирования>''{{Optional|,''<Язык форматирования (STRING)>''}}):''<Результат (STRING)>''
+'''FormatDate'''(''<Дата>''{{Optional|,<Шаблон форматирования (STRING)>,<Язык форматирования (STRING)>}}):''<Результат (STRING)>''
 </code>
 ==== Аргументы ====
 * <code>''<Дата>''</code> - Дата, которую необходимо преобразовать в строковой формат.
-* <code>''<Шаблон форматирования>''</code> - Строковое представление используется как текстовый шаблон для форматирования результата. В шаблоне могут присутствовать любые символы, однако, определенные комбинации символов будут превращены при форматировании в части исходной даты, все остальные символы, не принадлежащие заданным заранее комбинациям, будут скопированы в результат без изменения. Каждая комбинация состоит из заранее определенного числа символов или любого числа символов, см. ниже. Шаблон может включать следующие комбинации символов:
+* <code>''<Шаблон форматирования>''</code> - {{Optional}} Строковое представление используется как текстовый шаблон для форматирования результата. Если шаблон не задан (пустая строка), функция произведет простое форматирование исходной даты в виде <code>dd.mm.YYYY hh:tt:ss.ppp</code>, при этом часть ''.ppp'' будет опущена, если время даты задано точно в секундах, и ''hh:tt:ss.ppp'' будет опущена, если дата задана на начало дня. В шаблоне могут присутствовать любые символы, однако, определенные комбинации символов будут превращены при форматировании в части исходной даты, все остальные символы, не принадлежащие заданным заранее комбинациям, будут скопированы в результат без изменения. Каждая комбинация состоит из заранее определенного числа символов или любого числа символов, см. ниже. Шаблон может включать следующие комбинации символов:
 {|class="wikitable sortable" style="border-collapse:collapse;font-size:80%;width=95%;"
@@ Line 114: / Line 114: @@
 |Да
 |Подставляет числовое значение миллисекунды даты. Количество символов определяет минимальную длину результата, результат дополняется нулями с конца строки. Максимальное количество цифр равно трем, цифры после первых трех будут представлены нулями в конце числа. К примеру, если <code>ppp</code> возвращает числа 001, 012, 211, то <code>pppp</code> возвращает числа 0010, 0120, 2110, <code>pp</code> возвращает числа 00, 01, 21.
 |-align="left"
 |'''""'''

← Older revision	Revision as of 14:17, 16 April 2021
(No difference)

@@ Line 94: / Line 94: @@
+|
 |Подставляет числовое значение часа даты с символами интервала (вариант 2). Используется 12-часовой формат. Количество символов определяет минимальную длину результата, результат дополняется ведущими нулями. К примеру <code>HHHНН</code> возвращает числа 1 a.m., 2 p.m., 11 a.m., <code>HННHHH</code> возвращает числа 01 a.m., 02 p.m., 11 a.m..
 |-align="left"
 |'''t''' или '''T'''
@@ Line 105: / Line 113: @@
 |'''p''' или '''P'''
 |Да
-|Подставляет числовое значение миллисекунды даты. Количество символов определяет минимальную длину результата, результат дополняется нулями с конца строки. Минимальное количество цифр всегда равно трем. К примеру <code>p</code> возвращает числа 001, 012, 211, <code>pppp</code> возвращает числа 0010, 0120, 2110.
+|Подставляет числовое значение миллисекунды даты. Количество символов определяет минимальную длину результата, результат дополняется нулями с конца строки. Максимальное количество цифр равно трем, цифры после первых трех будут представлены нулями в конце числа. К примеру, если <code>ppp</code> возвращает числа 001, 012, 211, то <code>pppp</code> возвращает числа 0010, 0120, 2110, <code>pp</code> возвращает числа 00, 01, 21.
 |-align="left"
 |'''""'''

← Older revision	Revision as of 06:51, 7 February 2021
(No difference)