TheCloud/hugoDocs
1
0
Fork 0
mirror of https://github.com/gohugoio/hugoDocs.git synced 2025-09-13 06:49:26 -04:00
Code Issues Packages Projects Releases Wiki Activity

Update the .Unix function

Browse Source 
- Correct decscription
- Include Milli, Micro, and Nano variants
- Improve examples
This commit is contained in:
Joe Mooring 2021-11-20 15:08:45 -08:00 committed by Bjørn Erik Pedersen
parent 7310634880
commit 36c7879e4c
1 changed files with 17 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
content/en/functions/unix.md
View File

@ -1,35 +1,31 @@
--- ---
title: .Unix title: .Unix
draft: false description: Converts a time.Time value to the number of seconds elapsed since the Unix epoch, excluding leap seconds. The Unix epoch is 00:00:00 UTC on 1 January 1970.
description: .Unix returns the local Time corresponding to the given Unix time, sec seconds and nsec nanoseconds since January 1, 1970 UTC.
date: 2017-02-01 date: 2017-02-01
publishdate: 2017-02-01
lastmod: 2017-02-01
keywords: [dates,time] keywords: [dates,time]
categories: [functions] categories: [functions]
menu: menu:
docs: docs:
parent: "functions" parent: "functions"
signature: [".Unix"] signature: [".Unix",".UnixMilli",".UnixMicro",".UnixNano"]
workson: [times]
hugoversion:
relatedfuncs: [Format,dateFormat,now,time] relatedfuncs: [Format,dateFormat,now,time]
deprecated: false
aliases: []
--- ---
## Example: Time Passed Since Last Modification The `Milli`, `Micro`, and `Nano` variants return the number of milliseconds, microseconds, and nanoseconds (respectively) elapsed since the Unix epoch.
This very simple one-liner uses `now.Unix` to calculate the amount of time that has passed between the `.LastMod` for the current page and the last build of the current page. ```go-html-template
.Date.Unix --> 1637259694
.ExpiryDate.Unix --> 1672559999
.Lastmod.Unix --> 1637361786
.PublishDate.Unix --> 1637421261
{{< code file="time-passed.html" >}} ("1970-01-01T00:00:00-00:00" | time.AsTime).Unix --> 0
{{ div (sub now.Unix .Lastmod.Unix) 86400 }} ("1970-01-01T00:00:42-00:00" | time.AsTime).Unix --> 42
{{< /code >}} ("1970-04-11T01:48:29-08:00" | time.AsTime).Unix --> 8675309
("2026-05-02T20:09:31-07:00" | time.AsTime).Unix --> 1777777771
Since both values are integers, they can be subtracted and then divided by the number of seconds in a day (i.e., `60 * 60 * 24 == 86400`). now.Unix --> 1637447841
now.UnixMilli --> 1637447841347
{{% note %}} now.UnixMicro --> 1637447841347378
Hugo's output is *static*. For the example above to be realistic, the site needs to be built every day. now.UnixNano --> 1637447841347378799
{{% /note %}} ```
[partial template]: /templates/partials/