Gets the day of the week from 1 (Monday) to 7 (Sunday) of a timestamp field.

ParameterTypeRequiredDefault ValueDescription
asstringoptional[a] _dayOfWeek The name of the output field.
field[b]stringrequired @timestamp The name of the input field.
timezonestringoptional[a]   The time offset to use, for example, -01:00. If not specified, the query's offset will be used.
timezoneFieldstringoptional[a] @timezone The name of the field containing the timezone to use, if not specified the query's timezone will be used. This is ignored if the timezone parameter is passed as well. If this is not defined the timezone offset of the query will be used.

[a] Optional parameters use their default value unless explicitly set.

[b] The parameter name field can be omitted.

Hide omitted argument names for this function

Show omitted argument names for this function

Click + next to an example below to get the full details.

Extract Day of Week From Timestamp

Get the day of week from a timestamp using the time:dayOfWeek() function

Query
logscale
time:dayOfWeek(timestamp, as=weekday)
Introduction

In this example, the time:dayOfWeek() function is used to extract the day from a specific timestamp 2025-08-27 08:51:51.000, demonstrating how to get the weekday value from a datetime.

Step-by-Step

  1. Starting with the source repository events.

  2. logscale
    time:dayOfWeek(timestamp, as=weekday)

    Extracts the day of the week from the @timestamp field and returns the result in a new field named weekday. If the as parameter is not specified, the result is returned in a field named _dayOfWeek as default.

  3. Event Result set.

Summary and Results

The query is used to extract the day of the week from a timestamp, which is useful for analyzing event patterns across different days of the week.

This query is useful, for example, to analyze weekly patterns, group events by weekday, or identify activity trends within weeks.

Sample output from the incoming example data:

@timestampweekday
2025-08-27 08:51:51.0003

The result shows how the time:dayOfWeek() function extracts the day of the week (in this case 3) from the timestamp, indicating that August 27, 2025, is a Wednesday.

For visualizing this data, consider using a Bar Chart widget to show event counts by day of week, or a Heat Map widget to display activity patterns across weekdays. The time:dayOfWeek() function is often used with other time functions like time:month() and time:year() for complete date analysis.