Рекуррентные счета. Форматы дат и модификаторы
Документация находится в разработке
Оглавление
Примеры использования
| Формула | Результат работы | Описание |
|---|---|---|
| {[Y]} | 2023 | Текущий год |
| {[m/y]} | 04/23 | Текущий месяц и год в кратком формате |
| {[d F Y]} | 18 Апреля 2023 | Вывод конкретной даты в полном формате |
| {[d F Y] first day of next month} | 01 Мая 2023 | Первое число месяца следующего за текушим |
| {[d F Y] first monday} | 24 Апреля 2023 | Ближайший понедельник |
| {[F Y] +3 month} | Июль 2023 | Месяц и год через три месяца от даты |
| {[d-m-y] last day of this month} | 30-04-23 | Последний день текущего месяца в кратком формате |
Форматы дат
Символ в строке format
|
Описание | Пример возвращаемого значения |
|---|---|---|
| День | --- | --- |
d
|
День месяца, 2 цифры с ведущим нулём |
от 01 до 31
|
D
|
Текстовое представление дня недели, 3 символа |
от Mon до Sun
|
j
|
День месяца без ведущего нуля |
от 1 до 31
|
l (строчная 'L')
|
Полное наименование дня недели |
от Sunday до Saturday
|
N
|
Порядковый номер дня недели в соответствии со стандартом ISO 8601 |
от 1 (понедельник) до 7 (воскресенье)
|
S
|
Английский суффикс порядкового числительного дня месяца, 2 символа |
st, nd, rd или
th. Применяется совместно с j
|
w
|
Порядковый номер дня недели |
от 0 (воскресенье) до 6 (суббота)
|
z
|
Порядковый номер дня в году (начиная с 0) |
От 0 до 365
|
| Неделя | --- | --- |
W
|
Порядковый номер недели года в соответствии со стандартом ISO 8601; недели начинаются с понедельника |
Например: 42 (42-я неделя года)
|
| Месяц | --- | --- |
F
|
Полное наименование месяца, например, January или March |
от January до December
|
m
|
Порядковый номер месяца с ведущим нулём |
от 01 до 12
|
M
|
Сокращённое наименование месяца, 3 символа |
от Jan до Dec
|
n
|
Порядковый номер месяца без ведущего нуля |
от 1 до 12
|
t
|
Количество дней в указанном месяце |
от 28 до 31
|
| Год | --- | --- |
L
|
Признак високосного года |
1, если год високосный, иначе 0.
|
o
|
Номер года в соответствии со стандартом ISO 8601. Имеет то же значение, что и
Y, кроме случая, когда номер недели ISO
(W) принадлежит предыдущему или следующему году; тогда
будет использован год этой недели.
|
Примеры: 1999 или 2003
|
X
|
Расширенное полное числовое представление года,
не менее 4 цифр, с - для годов до нашей эры
и + для годов нашей эры.
|
Примеры: -0055, +0787,
+1999, +10191
|
x
|
Расширенное полное числовое представление, если требуется
или стандартное полное числовое представление,
если возможно (например, Y). Не менее четырёх цифр.
Для годов до нашей эры указан префикс -.
У годов после (и включая) 10000 префикс +.
|
Примеры: -0055, 0787,
1999, +10191
|
Y
|
Полное числовое представление года, не менее 4 цифр, с - для годов до нашей эры.
|
Примеры: -0055, 0787,
1999, 2003,
10191.
|
y
|
Номер года, 2 цифры |
Примеры: 99, 03
|
Модификаторы
| Описание | Формат |
|---|---|
dayname (наименование дня недели)
|
'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sun' | 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat' |
daytext (интервалы в неделях)
|
'weekday' | 'weekdays' |
number
|
[+-]?[0-9]+ |
ordinal (порядковые числительные и указатели)
|
'first' | 'second' | 'third' | 'fourth' | 'fifth' | 'sixth' | 'seventh' | 'eighth' | 'ninth' | 'tenth' | 'eleventh' | 'twelfth' | 'next' | 'last' | 'previous' | 'this' |
reltext (указатели)
|
'next' | 'last' | 'previous' | 'this' |
space (символы пробела и табуляции)
|
[ \t]+ |
unit (интервалы)
|
'ms' | 'µs' | (( 'msec' | 'millisecond' | 'µsec' | 'microsecond'
| 'usec' | 'sec' | 'second' | 'min' | 'minute' | 'hour' | 'day' |
'fortnight' | 'forthnight' | 'month' | 'year') 's'?) | 'weeks' |
daytext
|
| Формат | Описание | Примеры |
|---|---|---|
| 'yesterday' | Полночь вчера | "yesterday 14:00" |
| 'midnight' | Время устанавливается в 00:00:00 | |
| 'today' | Время устанавливается в 00:00:00 | |
| 'now' | Текущее время | |
| 'noon' | Время устанавливается в 12:00:00 | "yesterday noon" |
| 'tomorrow' | Полночь завтра | |
'back of' hour
|
15 минут заданного часа | "back of 7pm", "back of 15" |
'front of' hour
|
Без 15 минут заданный час | "front of 5am", "front of 23" |
| 'first day of' | Устанавливает первый день текущего месяца. Обычно эту нотацию лучше использовать вместе с названием месяца, следующим за ней, иначе будет учитываться текущий месяц. | "first day of January 2008" |
| 'last day of' | Устанавливает последний день текущего месяца. Обычно эту нотацию лучше использовать вместе с названием месяца, следующим за ней, иначе будет учитываться текущий месяц. | "last day of next month" |
ordinal space dayname space 'of'
|
Вычисляет x день недели текущего или заданного месяца.
|
"first sat of July 2008" |
'last' space dayname space 'of'
|
Вычисляет последний день недели текущего или заданного месяца. | "last sat of July 2008" |
number space? (unit | 'week')
|
Вычисляет относительное время при использовании числовых значений периода. | "+5 weeks", "12 day", "-7 weekdays" |
ordinal space unit
|
Вычисляет относительное время при использовании строковых значений периода. | "fifth day", "second month" |
| 'ago' | Вычитает все значения из последнего полученного момента времени. | "2 days ago", "8 days ago 14:00", "2 months 5 days ago", "2 months ago 5 days", "2 days ago ago" |
dayname
|
Перемещается на следующий день указанного дня недели | "Monday" |
reltext space 'week'
|
Разбирает специфичный формат "weekday + last/this/next week". | "Monday next week" |
