formatDate

Функция formatDate предназначена для форматирования дат в базах данных Notion. С ее помощью даты выводятся по заданной маске, что значительно упрощает считывание информации пользователем приложения. Функция также используется для извлечения из дат отдельных составляющих для осуществления дальнейших манипуляций (сравнения дат, вывода автоматически генерируемых статусов, сортировки, группировки, фильтрации).

Синтаксис

formatDate(date, format, timezone?)
date
Обязательный аргумент (Date). Дата, которую необходимо отформатировать. Может содержать обращение к свойству базы данных с датой, а также функцию, возвращающую дату.
format
Обязательный аргумент (Text). Строка c ключами и другими символами, с помощью которых формируется маска вывода. Может содержать строковый литерал, обращение к свойству базы данных с текстом, а также функцию, возвращающую текст.
timezone
Необязательный аргумент (Text). Часовой пояс, на который нужно скорректировать выводимые дату и время. Может содержать строковый литерал, обращение к свойству базы данных с текстом, а также функцию, возвращающую текст.

Возвращает Text.

Хотите чувствовать себя в Notion как рыба в воде?

Подпишитесь на канал автора сайта «Формулы Notion 2.0» с обзорами новых функций, советами начинающим и продвинутым пользователям, шаблонами, видеоуроками и эксклюзивными формулами! Перейти

Особенности

Функция Notion formatDate возвращает данные в формате Text, что не всегда удобно для сортировки, группировки, фильтрации и осуществления математических операций. Для получения отдельных составляющих даты вместо formatDate можно использовать следующие функции, возвращающие Number:

Функция formatDate не может использоваться для получения дат, предназначенных для вывода записей баз данных в календаре (Calendar view) и на диаграмме Ганта (Timeline view).

25 формул Notion на каждый день

Бесплатный шаблон для Notion с подборкой из 25 востребованных формул от автора сайта «Формулы Notion 2.0». Перейти

Ключи

Функция Notion formatDate поддерживает ряд ключей из библиотеки Moment.js.

Участники онлайн-курса «Формулы Notion 2.0» получат список ключей функции formatDate в виде удобного для работы шаблона Notion.

Обратите внимание: в таблицах приведены диапазоны значений для Notion (отличаются от диапазонов в исходной библиотеке) и при установке английского в качестве языка приложения. При выборе другого языка использование указанных ключей может приводить к иному результату. Например, ключ llll выводит Tue, Aug 9, 2022 9:03 PM на английском, ter. 9 de ago. de 2022 21:03 на португальском и 2022년 8월 9일 화요일 오후 9:03 на корейском.

Год

Ключ Что выводит Диапазон значений Пример
Y Номер года, от одной до четырех цифр 0 ... 9999 2022
YY Номер года, две последние цифры 00 ... 99 22
YYYY Номер года, четыре цифры (с ведущим нулем) 0000 ... 9999 2022
YYYYYY Номер года в формате «Расширенный ряд лет» +000000 ... +009999 +002022
GG Год недели ISO, две цифры -01 ... 99 22
GGGG Год недели ISO, четыре цифры -0001 ... 9999 2022
gg Год недели, две цифры -01 ... 99 22
gggg Год недели, четыре цифры -0001 ... 9999 2022

Квартал

Ключ Что выводит Диапазон значений Пример
Q Номер квартала 1 … 4 3
Qo Номер квартала, с окончанием порядкового числительного 1st … 4th 3rd

Месяц

Ключ Что выводит Диапазон значений Пример
M Номер месяца, одна или две цифры 1 ... 12 8
Mo Номер месяца, одна или две цифры, с окончанием порядкового числительного 1st ... 12th 8th
MM Номер месяца, две цифры (с ведущим нулем) 01 ... 12 08
MMM Название месяца, сокращенное, три буквы Jan ... Dec Aug
MMMM Название месяца, полное January ... December August

Неделя

Ключ Что выводит Диапазон значений Пример
W Номер недели ISO (начинается с понедельника), одна или две цифры 1 ... 53 32
Wo Номер недели ISO (начинается с понедельника), одна или две цифры, с окончанием порядкового числительного 1st ... 53rd 32nd
WW Номер недели ISO (начинается с понедельника), две цифры (с ведущим нулем) 01 ... 53 32
w Номер недели (начинается с воскресенья), одна или две цифры 1 ... 53 33
wo Номер недели (начинается с воскресенья), одна или две цифры, с окончанием порядкового числительного 1st ... 53rd 33rd
ww Номер недели (начинается с воскресенья), две цифры (с ведущим нулем) 01 ... 53 33

День

Ключ Что выводит Диапазон значений Пример
D Число – номер дня месяца, одна или две цифры 1 ... 31 9
Do Число – номер дня месяца, одна или две цифры, с окончанием порядкового числительного 1st ... 31st 9th
DD Число – номер дня месяца, две цифры (с ведущим нулем) 01 ... 31 09
DDD Номер дня года, одна, две или три цифры 1 ... 366 221
DDDo Номер дня года, одна, две или три цифры, с окончанием порядкового числительного 1st ... 366th 221st
DDDD Номер дня года, три цифры (с ведущими нулями) 001 ... 366 221
d Номер дня недели 0 ... 6 2
do Номер дня недели с окончанием порядкового числительного 0th ... 6th 2nd
dd Название дня недели, сокращенное, две буквы Su ... Sa Tu
ddd Название дня недели, сокращенное, три буквы Sun ... Sat Tue
dddd Название дня недели, полное Sunday ... Saturday Tuesday
E Номер дня недели ISO 1 ... 7 2
e Номер дня недели локали 0 ... 6 2

Интервал времени

Ключ Что выводит Диапазон значений Пример
A 12-часовой интервал времени, две буквы, заглавные AM PM PM
a 12-часовой интервал времени, две буквы, строчные am pm pm

Час

Ключ Что выводит Диапазон значений Пример
H Час в 24-часовом формате, одна или две цифры, полночь в 0 часов 0 ... 23 21
HH Час в 24-часовом формате, две цифры (с ведущим нулем), полночь в 00 часов 00 ... 23 21
h Час в 12-часовом формате, одна или две цифры 1 ... 12 9
hh Час в 12-часовом формате, две цифры (с ведущим нулем) 01 ... 12 09
k Час в 24-часовом формате, одна или две цифры, полночь в 24 часа 1 ... 24 9
kk Час в 24-часовом формате, две цифры (с ведущим нулем), полночь в 24 часа 01 ... 24 09

Минута

Ключ Что выводит Диапазон значений Пример
m Минута, одна или две цифры 0 ... 59 3
mm Минута, две цифры (с ведущим нулем) 00 ... 59 03

Секунда

Несмотря на то, что данные ключи поддерживаются, использовать их в формулах смысла нет, так как в Notion секунды обнуляются.

Ключ Что выводит Диапазон значений Пример
S Доля секунды, одна цифра 0 0
SS Доля секунды, две цифры (с ведущим нулем) 00 00
SSS Доля секунды, три цифры (с ведущими нулями) 000 000
s Секунда, одна или две цифры 0 0
ss Секунда, две цифры (с ведущим нулем) 00 00

Часовой пояс

Ключ Что выводит Пример
Z Часовой пояс по маске ±hh:mm +03:00
ZZ Часовой пояс по маске ±hhmm +0300
ZZZ Название часового пояса, полное Moscow Standard Time
z, zz Часовой пояс по Гринвичу GMT+3

Ранее ключи z, zz выводили в Notion сокращенное название часового пояса из трех букв (например, MSK). Теперь они выводят часовой пояс по Гринвичу.

Метка времени

Ключ Что выводит Диапазон значений Пример
X Метка времени Unix в секундах -62167228217 ... 253402289940 1660068180
x Метка времени Unix в миллисекундах -62167228217000 ... 253402289940000 1660068180000

При формировании метки времени в Notion секунды обнуляются.

Дата и время по маске

Ключ Что выводит Пример
L Дата по маске MM/DD/YYYY 08/09/2022
LL Дата по маске MMMM D, YYYY August 9, 2022
LLL Дата и время по маске MMMM D, YYYY h:mm A August 9, 2022 9:03 PM
LLLL Дата и время по маске dddd, MMMM D, YYYY h:mm Tuesday, August 9, 2022 9:03 PM
LT Время по маске h:mm A 9:03 PM
LTS Время по маске h:mm:ss A 9:03:00 PM
l Дата по маске M/D/YYYY 8/9/2022
ll Дата по маске MMM D, YYYY Aug 9, 2022
lll Дата и время по маске MMM D, YYYY h:mm A Aug 9, 2022 9:03 PM
llll Дата и время по маске ddd, MMM D, YYYY h:mm A Tue, Aug 9, 2022 9:03 PM

Использование

Принцип работы formatDate (дата по маске)

/* https://notionformulas.chumakova.ru */formatDate(
	prop("Дата"), /* Дата, которую нужно отформатировать */
	"YYYY/MM/DD" /* Маска вывода, содержащая ключи и другие символы */
)
/* https://notionformulas.chumakova.ru */prop("Дата").formatDate("YYYY/MM/DD")
Формула Notion 2.0 «Принцип работы formatDate (дата по маске)»

В этой формуле используется prop.

Регулировка часового пояса в функции formatDate

/* https://notionformulas.chumakova.ru */formatDate(now(), "HH:mm", prop("Часовой пояс"))
/* https://notionformulas.chumakova.ru */now().formatDate("HH:mm", prop("Часовой пояс"))
Формула Notion 2.0 «Регулировка часового пояса в функции formatDate»

В этой формуле используются: prop, now.

Отдельные составляющие даты

Отдельные составляющие даты, полученные с помощью функции Notion formatDate, чаще всего используются для сортировки, группировки и фильтрации записей в Notion.

Сортировка, группировка и фильтрация данных по значениям свойства Formula имеют свою специфику. См. Сортировка, группировка, фильтрация.

Минуты (formatDate)

/* https://notionformulas.chumakova.ru */formatDate(prop("Дата"), "m")
/* https://notionformulas.chumakova.ru */prop("Дата").formatDate("m")
Формула Notion 2.0 «Минуты (formatDate)»

В этой формуле используется prop.

Часы (formatDate)

/* https://notionformulas.chumakova.ru */formatDate(prop("Дата"), "H")
/* https://notionformulas.chumakova.ru */prop("Дата").formatDate("H")
Формула Notion 2.0 «Часы (formatDate)»

В этой формуле используется prop.

Число месяца (formatDate)

/* https://notionformulas.chumakova.ru */formatDate(prop("Дата"), "D")
/* https://notionformulas.chumakova.ru */prop("Дата").formatDate("D")
Формула Notion 2.0 «Число месяца (formatDate)»

В этой формуле используется prop.

Номер дня недели (formatDate)

/* https://notionformulas.chumakova.ru */formatDate(prop("Дата"), "d")
/* https://notionformulas.chumakova.ru */prop("Дата").formatDate("d")
Формула Notion 2.0 «Номер дня недели (formatDate)»

В этой формуле используется prop.

Номер недели (formatDate)

/* https://notionformulas.chumakova.ru */formatDate(prop("Дата"), "W")
/* https://notionformulas.chumakova.ru */prop("Дата").formatDate("W")
Формула Notion 2.0 «Номер недели (formatDate)»

В этой формуле используется prop.

Номер месяца (formatDate)

/* https://notionformulas.chumakova.ru */formatDate(prop("Дата"), "M")
/* https://notionformulas.chumakova.ru */prop("Дата").formatDate("M")
Формула Notion 2.0 «Номер месяца (formatDate)»

В этой формуле используется prop.

Название месяца

/* https://notionformulas.chumakova.ru */formatDate(prop("Дата"), "MMMM")
/* https://notionformulas.chumakova.ru */prop("Дата").formatDate("MMMM")
Формула Notion 2.0 «Название месяца»

Номер квартала

/* https://notionformulas.chumakova.ru */formatDate(prop("Дата"), "Q")
/* https://notionformulas.chumakova.ru */prop("Дата").formatDate("Q")
Формула Notion 2.0 «Номер квартала»

В этой формуле используется prop.

Номер года (formatDate)

/* https://notionformulas.chumakova.ru */formatDate(prop("Дата"), "YYYY")
/* https://notionformulas.chumakova.ru */prop("Дата").formatDate("YYYY")
Формула Notion 2.0 «Номер года (formatDate)»

В этой формуле используется prop.

Руссификация составляющих даты

В Notion названия составляющих даты могут быть выведены только на английском, корейском, японском, французском, немецком, испанском, португальском, финском, датском, нидерландском, норвежском и шведском языках языках (в зависимости от выбранного языка приложения). Формулы с использованием функции formatDate позволяют руссифицировать их.

Название дня недели на русском (formatDate)

Для данной формулы доступен только предпросмотр. Формула предназначена для демонстрации возможностей Notion. Научиться писать сложные формулы Notion можно в ходе онлайн-курса «Формулы Notion 2.0» от автора этого справочника.

Формула Notion 2.0 «Название дня недели на русском (formatDate)»

Название месяца на русском (formatDate)

Для данной формулы доступен только предпросмотр. Формула предназначена для демонстрации возможностей Notion. Научиться писать сложные формулы Notion можно в ходе онлайн-курса «Формулы Notion 2.0» от автора этого справочника.

Формула Notion 2.0 «Название месяца на русском (formatDate)»

Название времени года на русском

Для данной формулы доступен только предпросмотр. Формула предназначена для демонстрации возможностей Notion. Научиться писать сложные формулы Notion можно в ходе онлайн-курса «Формулы Notion 2.0» от автора этого справочника.

Формула Notion 2.0 «Название времени года на русском»

Российские форматы даты

Notion не поддерживает российские форматы даты. Формулы с использованием функции formatDate позволяют выводить даты в привычном виде.

Дата по маске ДД.ММ.ГГГГ

/* https://notionformulas.chumakova.ru */formatDate(prop("Дата"), "DD.MM.YYYY")
/* https://notionformulas.chumakova.ru */prop("Дата").formatDate("DD.MM.YYYY")
Формула Notion 2.0 «Дата по маске ДД.ММ.ГГГГ»

В этой формуле используется prop.

Дата и время по маске ДД.ММ.ГГГГ ЧЧ:мм

/* https://notionformulas.chumakova.ru */formatDate(prop("Дата"), "DD.MM.YYYY HH:mm")
/* https://notionformulas.chumakova.ru */prop("Дата").formatDate("DD.MM.YYYY HH:mm")
Формула Notion 2.0 «Дата и время по маске ДД.ММ.ГГГГ ЧЧ:мм»

В этой формуле используется prop.

Дата на русском по маске ДД месяца ГГГГ г.

Для данной формулы доступен только предпросмотр. Формула предназначена для демонстрации возможностей Notion. Научиться писать сложные формулы Notion можно в ходе онлайн-курса «Формулы Notion 2.0» от автора этого справочника.

Формула Notion 2.0 «Дата на русском по маске ДД месяца ГГГГ г.»

Международные форматы даты

Notion поддерживает небольшое количество международных форматов даты. Формулы с использованием функции formatDate позволяют выводить даты в любом из них.

Дата и время в формате ISO 8601

/* https://notionformulas.chumakova.ru */formatDate(prop("Дата"), "YYYY-MM-DD[T]HH:mm:ssZ")
/* https://notionformulas.chumakova.ru */prop("Дата").formatDate("YYYY-MM-DD[T]HH:mm:ssZ")
Формула Notion 2.0 «Дата и время в формате ISO 8601»

В этой формуле используется prop.

Дата и время в формате RFC 822

/* https://notionformulas.chumakova.ru */formatDate(prop("Дата"), "ddd, D MMM YY HH:mm:ss Z")
/* https://notionformulas.chumakova.ru */prop("Дата").formatDate("ddd, D MMM YY HH:mm:ss Z")
Формула Notion 2.0 «Дата и время в формате RFC 822»

В этой формуле используется prop.

События в настоящем (текущие задачи)

В этом разделе представлены формулы для Notion с использованием функции formatDate, которые позволяют определить, попадают ли даты в базе данных в интервал текущего календарного периода.

Дата сегодня?

/* https://notionformulas.chumakova.ru */prop("Дата") == today()
/* https://notionformulas.chumakova.ru */equal(prop("Дата"), today())
/* https://notionformulas.chumakova.ru */prop("Дата").equal(today())
Формула Notion 2.0 «Дата сегодня?»

Скриншот от 09.06.2024

В этой формуле используются: prop, ==, today, equal.

Сегодня в диапазоне?

/* https://notionformulas.chumakova.ru */let(
	format, "YYYYMMDD",
	prop("Дата").dateStart().formatDate(format).parseDate() <= today() &&
	today() <= prop("Дата").dateEnd().formatDate(format).parseDate()
)
Формула Notion 2.0 «Сегодня в диапазоне?»

Скриншот от 09.06.2024

В этой формуле используются: let, prop, dateStart, parseDate, <=, today, && (and), dateEnd.

Дата на этой календарной неделе?

/* https://notionformulas.chumakova.ru */formatDate(prop("Дата"), "YYYYWW") == formatDate(today(), "YYYYWW")
/* https://notionformulas.chumakova.ru */prop("Дата").formatDate("YYYYWW") == today().formatDate("YYYYWW")
Формула Notion 2.0 «Дата на этой календарной неделе?»

Скриншот от 09.06.2024

В этой формуле используются: prop, ==, today.

События в будущем (предстоящие задачи)

В этом разделе представлены формулы для Notion с использованием функции formatDate, которые позволяют определить, попадают ли даты в базе данных в интервал будущего календарного периода.

Дата завтра?

Для данной формулы доступен только предпросмотр. Формула предназначена для демонстрации возможностей Notion. Научиться писать сложные формулы Notion можно в ходе онлайн-курса «Формулы Notion 2.0» от автора этого справочника.

Формула Notion 2.0 «Дата завтра?»

Скриншот от 09.06.2024

Дата завтра или позднее?

/* https://notionformulas.chumakova.ru */formatDate(prop("Дата и время"), "YYYYMMDD") > formatDate(today(), "YYYYMMDD")
/* https://notionformulas.chumakova.ru */prop("Дата и время").formatDate("YYYYMMDD") > today().formatDate("YYYYMMDD")
Формула Notion 2.0 «Дата завтра или позднее?»

Скриншот от 09.06.2024

В этой формуле используются: prop, >, today.

Дата на следующей календарной неделе?

Для данной формулы доступен только предпросмотр. Формула предназначена для демонстрации возможностей Notion. Научиться писать сложные формулы Notion можно в ходе онлайн-курса «Формулы Notion 2.0» от автора этого справочника.

Формула Notion 2.0 «Дата на следующей календарной неделе?»

Скриншот от 09.06.2024

Дата на следующей календарной неделе или позднее?

Для данной формулы доступен только предпросмотр. Формула предназначена для демонстрации возможностей Notion. Научиться писать сложные формулы Notion можно в ходе онлайн-курса «Формулы Notion 2.0» от автора этого справочника.

Формула Notion 2.0 «Дата на следующей календарной неделе или позднее?»

Скриншот от 09.06.2024

События в прошлом (просроченные задачи)

В этом разделе представлены формулы для Notion с использованием функции formatDate, которые позволяют определить, попадают ли даты в базе данных в интервал прошедшего календарного периода.

Дата вчера?

Для данной формулы доступен только предпросмотр. Формула предназначена для демонстрации возможностей Notion. Научиться писать сложные формулы Notion можно в ходе онлайн-курса «Формулы Notion 2.0» от автора этого справочника.

Формула Notion 2.0 «Дата вчера?»

Скриншот от 09.06.2024

Дата вчера или ранее?

/* https://notionformulas.chumakova.ru */formatDate(prop("Дата и время"), "YYYYMMDD") < formatDate(today(), "YYYYMMDD")
/* https://notionformulas.chumakova.ru */prop("Дата и время").formatDate("YYYYMMDD") < today().formatDate("YYYYMMDD")
Формула Notion 2.0 «Дата вчера или ранее?»

Скриншот от 09.06.2024

В этой формуле используются: prop, <, today.

Дата на предыдущей календарной неделе?

Для данной формулы доступен только предпросмотр. Формула предназначена для демонстрации возможностей Notion. Научиться писать сложные формулы Notion можно в ходе онлайн-курса «Формулы Notion 2.0» от автора этого справочника.

Формула Notion 2.0 «Дата на предыдущей календарной неделе?»

Скриншот от 09.06.2024

Дата на предыдущей календарной неделе или ранее?

Для данной формулы доступен только предпросмотр. Формула предназначена для демонстрации возможностей Notion. Научиться писать сложные формулы Notion можно в ходе онлайн-курса «Формулы Notion 2.0» от автора этого справочника.

Формула Notion 2.0 «Дата на предыдущей календарной неделе или ранее?»

Скриншот от 09.06.2024

Часы и таймеры

Функция Notion formatDate используется при создании часов и таймеров.

Часы (дата и время)

Для данной формулы доступен только предпросмотр. Формула предназначена для демонстрации возможностей Notion. Научиться писать сложные формулы Notion можно в ходе онлайн-курса «Формулы Notion 2.0» от автора этого справочника.

Формула Notion 2.0 «Часы (дата и время)»

Скриншот от 09.06.2024.

Вывод формулы обновляется при открытии или перезагрузке страницы.

Таймер обратного отсчета до Нового года

Для данной формулы доступен только предпросмотр. Формула предназначена для демонстрации возможностей Notion. Научиться писать сложные формулы Notion можно в ходе онлайн-курса «Формулы Notion 2.0» от автора этого справочника.

Формула Notion 2.0 «Таймер обратного отсчета до Нового года»

Скриншот от 09.06.2024.

Вывод формулы обновляется при открытии или перезагрузке страницы.

Таймер обратного отсчета до заданной даты

Для данной формулы доступен только предпросмотр. Формула предназначена для демонстрации возможностей Notion. Научиться писать сложные формулы Notion можно в ходе онлайн-курса «Формулы Notion 2.0» от автора этого справочника.

Формула Notion 2.0 «Таймер обратного отсчета до заданной даты»

Скриншот от 09.06.2024

Вывод формулы обновляется при открытии или перезагрузке страницы.

Другие решения с использованием formatDate

Время из даты

/* https://notionformulas.chumakova.ru */if(
	contains(prop("Дата"), ":"),
	formatDate(prop("Дата"), "HH:mm"),
	""
)
/* https://notionformulas.chumakova.ru */prop("Дата").contains(":").if(prop("Дата").formatDate("HH:mm"), "")
Формула Notion 2.0 «Время из даты»

В этой формуле используются: if, contains, prop.

Управление сменами сотрудников

Формула показывает продолжительность смены, а также количество дней до следующей смены. Осуществлять планирование можно непосредственно на диаграмме Ганта (Timeline view): добавлять новые смены, устанавливать их продолжительность (растягивать, сужать), изменять сроки (перемещать перетаскиванием).

Для данной формулы доступен только предпросмотр. Формула предназначена для демонстрации возможностей Notion. Научиться писать сложные формулы Notion можно в ходе онлайн-курса «Формулы Notion 2.0» от автора этого справочника.

Формула Notion 2.0 «Управление сменами сотрудников»