Рекуррентные счета. Форматы дат и модификаторы
Документация находится в разработке
Оглавление
Примеры использования
| Формула | Результат работы | Описание |
|---|---|---|
| {[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" |
