hugoDocs/content/functions/unix.md

title	linktitle	description	godocref	date	publishdate	lastmod	tags	categories	signature	workson	hugoversion	relatedfuncs	deprecated	aliases
unix	Unix	Unix returns the local Time corresponding to the given Unix time, sec seconds and nsec nanoseconds since January 1, 1970 UTC.	https://golang.org/search?q=Unix#Functions	2017-02-01	2017-02-01	2017-02-01	dates time	functions				Format dateFormat now time	false

Unix returns t as a Unix time; i.e., the number of seconds elapsed since January 1, 1970 UTC.

Unix Example 1: Show Only Upcoming Events

The following assumes you have a content section called events (i.e., content/events/*.md). The following partial template allows you to only list events that haven't occurred yet.

{{% code file="layouts/partials/upcoming-events.html" download="upcoming-events.html" %}}

<h4>Upcoming Events</h4>
<ul class="upcoming-events">
{{ range where .Data.Pages.ByDate "Section" "events" }}
  {{ if ge .Date.Unix .Now.Unix }}
    <li><span class="event-type">{{ .Type | title }} —</span>
      {{ .Title }}
      on <span class="event-date">
      {{ .Date.Format "2 January at 3:04pm" }}</span>
      at {{ .Params.place }}
    </li>
  {{ end }}
{{ end }}
</ul>

{{% /code %}}

Unix Example 2: Time Passed Since Last Modification

This very simple one-liner uses Unix with Now to calculate the amount of time that has passed between the .LastMod for the current page and the last build of the current page.

{{% code file="time-passed.html" %}}

{{ div (sub .Now.Unix .Lastmod.Unix) 86400 }}

{{% /code %}}

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).

{{% note %}} Hugo's output is static. In example 2, a month-old page published on a Hugo site that only publishes monthly could easily misrepresented the last update as yesterday rather than 30 days ago. {{% /note %}}