Embed Variables

Zipline lets you specify the locale and timezone for the locale, time, and date modifiers. To achieve this you need to specify the 2nd modifier: {user.createdAt::locale::en-UK,Europe/London}.

For example using {user.createdAt::locale::ja-JP,Asia/Tokyo} will format the date to the Japanese locale and timezone and will yield a result of 2024/9/22 19:30:00 when the system time is 9/22/2024 11:30 AM in the America/Los_Angeles timezone.

It is also possible to continue using the system locale, but specify a different timezone. To do this just specify the timezone: {user.createdAt::locale::,Europe/London}. Notice the comma is right after the double colons.

Some specific use cases for this may be if you want to use 24-hour time but continue using an American timezone, you can use {user.createdAt::locale::en-UK,America/Los_Angeles}. This will format the date and time to use 24-hour time and dd/mm/yyyy format instead of the default mm/dd/yyyy format used in the US.

If you are looking for a list of possible locales, you can visit https://www.unicode.org/cldr/charts/44/supplemental/language_territory_information.html. To use this table, take the language code ("Code" in the table) and the territory code ("Territory" in the table) and combine them with a hyphen. For example, the code for English in the United Kingdom is en-UK, and the code for Japanese in Japan is ja-JP.

A list of timezones can be found at https://en.wikipedia.org/wiki/List_of_tz_database_time_zones. Use the value under the "TZ identifier" column.

To use conditional modifiers, you need to add them after the variable with a double colon ::, like normal modifiers but with a different format: {variableName.property::conditionalModifier["trueString"||"falseString"]}.

For example, to show the file's views if it has max views, you would use {file.maxViews::>0["{file.views}/{file.maxViews}"||"No max views"]}. This will show the views and max views if the max views are greater than 0, otherwise it will show "No max views".