hugo/docs/content/en/functions/time/AsTime.md

title	description	categories	keywords	action	aliases	toc
time.AsTime	Returns the given string representation of a date/time value as a time.Time value.			aliases related returnType signatures time functions/time/Duration functions/time/Format functions/time/Now functions/time/ParseDuration time.Time time.AsTime INPUT [TIMEZONE]	/functions/time	true

Overview

Hugo provides functions and methods to format, localize, parse, compare, and manipulate date/time values. Before you can do any of these with string representations of date/time values, you must first convert them to time.Time values using the time.AsTime function.

{{ $t := "2023-10-15T13:18:50-07:00" }}
{{ time.AsTime $t }} → 2023-10-15 13:18:50 -0700 PDT (time.Time)

Parsable strings

As shown above, the first argument must be a parsable string representation of a date/time value. For example:

{{% include "functions/time/_common/parsable-date-time-strings.md" %}}

To override the default time zone, set the timeZone in your site configuration or provide a second argument to the time.AsTime function. For example:

{{ time.AsTime "15 Oct 2023" "America/Los_Angeles" }}

The list of valid time zones may be system dependent, but should include UTC, Local, or any location in the IANA Time Zone database.

The order of precedence for determining the time zone is:

1. The time zone offset in the date/time string
2. The time zone provided as the second argument to the time.AsTime function
3. The time zone specified in your site configuration
4. The Etc/UTC time zone