1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
|
---
title: ByDate
description: Returns the given page collection sorted by date in ascending order.
categories: []
keywords: []
action:
related:
- methods/pages/ByExpiryDate
- methods/pages/ByLastMod
- methods/pages/ByPublishDate
returnType: page.Pages
signatures: [PAGES.ByDate]
---
When sorting by date, the value is determined by your [site configuration], defaulting to the `date` field in front matter.
[site configuration]: /getting-started/configuration/#configure-dates
```go-html-template
{{ range .Pages.ByDate }}
<h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}
```
To sort in descending order:
```go-html-template
{{ range .Pages.ByDate.Reverse }}
<h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}
```
|