minute() function returns an integer (number) between
59 that corresponds to the minute of its date argument.
minute() (and its sibling functions hour, day, date, month, and year) is useful for manipulating dates within Notion formulas.
minute(now()) // Output: 25 (When current time was 11:25 AM) // Assume a property called Date with a current date of June 24, 2022 11:29 AM minute(prop("Date")) // Output: 29
minute() can be used with other functions such as dateSubtract to change the value of a date, like so:
// Assume the value of now() is June 24, 2022 11:34 AM dateSubtract(now(), minute(now()), "minutes") // Output: June 24, 2022 11:00 AM
You can take this concept even further to “hard-code” any date into a Notion formula. See the section on Hard-Coding Dates into Formulas within the now article for more on how to do this.
This example database shows both the current time (using the now function), as well as the current time rounded to the nearest hour.
View and Duplicate Database
“Nearest Hour” Property Formula
// Compressed if(minute(now()) < 30, dateSubtract(now(), minute(now()), "minutes"), dateAdd(now(), 60 - minute(now()), "minutes")) // Expanded if( minute( now() ) < 30, dateSubtract( now(), minute( now() ), "minutes" ), dateAdd( now(), 60 - minute( now() ), "minutes" ) )
First, an if statement checks if the minute value of now is less than 30.
If so, we subtract
now()‘s minute value from
now() in order to get to the current hour.
If not, we add
now()‘s minute value to
now() in order to get to the next hour.