World Clock
The world clock column will hold the current time of any place in the world. This can be useful for seeing times across different time zones.
Check out our help center to learn more about the world clock column.
Reading the world clock column
You can return the data in a world clock column in two different formats. The text field will return the data as a simple string, and the value field will return the data as a JSON string.
Here is an example payload showing both fields:
{
"text": "US/Pacific",
"value": "{\"timezone\":\"US/Pacific\",\"changed_at\":\"2022-07-21T12:00:00.000Z\"}"
}
Updating the world clock column
You can update a world clock column with a JSON string. Simple string updates are not supported.
JSON
To update a world clock column, send the timezone of the user as a string in continent/city form. You can find the list of available timezones here.
For example: "{\"timezone\":\"Europe/London\"}"
Code example
mutation {
change_multiple_column_values(item_id:11111, board_id:22222, column_values: "{\"world_clock\" : {\"timezone\" : \"Europe/London\"}}") {
id
}
}
fetch ("https://api.monday.com/v2", {
method: 'post',
headers: {
'Content-Type': 'application/json',
'Authorization' : 'YOUR_API_KEY'
},
body: JSON.stringify({
query : "mutation ($myBoardId:Int!, $myItemId:Int!, $myColumnValues:JSON!) { change_multiple_column_values(item_id:$myItemId, board_id:$myBoardId, column_values: $myColumnValues) { id }}",
variables : JSON.stringify({
myBoardId: YOUR_BOARD_ID,
myItemId: YOUR_ITEM_ID,
myColumnValues: "{\"world_clock\" : {\"timezone\" : \"Europe/London\"}}"
})
})
})
curl "https://api.monday.com/v2" \
-X POST \
-H "Content-Type:application/json" \
-H "Authorization:MY_API_KEY" \
-d '{"query":"mutation{change_multiple_column_values(item_id:162169283, board_id:162169280, column_values:\"{\\\"world_clock\\\" : {\\\"timezone\\\" : \\\"Europe/London\\\"}}\"){name}}"}'
Do you have questions?
Join our developer community! You can share your questions and learn from fellow users and monday.com product experts.
Don’t forget to search before opening a new topic!
Updated 7 days ago