Day of the year (dayofyear)
Returns the day of the year from a given timestamp. Optionally, you can check it in a time zone different than yours.
How does it work in the search window?
Select Create column in the search window toolbar, then select the Day of the year operation.
If you only add the Timestamp argument, you will get the day of the year considering your current timezone. Optionally, you can specify a different time zone adding the Time zone argument to see the day of the year in the specified timezone.
You can either select a column with that data type or introduce it manually.
In case you want to introduce it, note that this value should be a date: Year-Month_Day Hour:Minute:Second.Millisecond (yyyy-MM-dd HH:mm:ss.SSS) → You can skip seconds and milliseconds.
You need a valid string format the app can recognize so it returns meaningful results. You can use one of the following:
You can check the time zone codes and region names in the Configure Timezone window in Devo. Be aware that some of the codes coincide, as CST could mean Central Standard Time or China Standard Time. In that case, it would be advisable to introduce the time zone's full name. You can find them listed in the following link.
If you leave the field empty or introduce a value the app cannot recognize, it will automatically set the Time Zone argument as UTC so you will see the time in your time zone when the previous day started in UTC.
The data type of the new column values will be integer and the values shown will be 0-364 (0-365 in leap years), where 0 is the first day of the year and 364 (365 in leap years) is the last one. Since the count starts at 0, note that the result will be the day - 1 (for example, if the day of the year is 200, you will get 199).
Be aware that timestamps taking place during summer will be affected in the time zones in which they set the clock forward during summer. For example, Europe/Madrid (CET-Central European Time), which is UTC+1, becomes UTC+2 during summertime and thus timestamps in August will be affected when using that time zone. Be also aware that summertime differs between the Northern and Southern Hemispheres.
demo.ecommerce.data table, we want to create a column that indicates the day of the year of the dates in our eventdate column. To do it, we will create a new column using the Day of the year operation.
The arguments needed to create the new column are:
- Timestamp - eventdate column
Click Create column and you will see the following result:
How does it work in LINQ?
Use the operator
as... and add the operation syntax to create the new column. These are the valid formats for the Day of the year operation:
dayofyear(timestamp)→ Use this expression to get the day of the year corresponding to the given timestamps, according to your current time zone.
dayofyear(timestamp, timezone_string)→ Use this expression to get the day of the year corresponding to the given timestamps, according to the specified time zone.
You can copy the following LINQ script and try the above example on the
from demo.ecommerce.data select dayofyear(eventdate) as eventdate_day_year