Date

The Date plugin is disabled by default so you need to enable it in _config.js file:

import date from "lume/plugins/date.js";

site.use(date());

This plugin register the date filter, that allows to manipulate and format a datetime value in different locales. It uses date-fns library under the hood.

<time>{{ createdAt | date }}</time>

Formats

By default, the value is formatted to yyyy-MM-dd but you can use the first argument to set a different format. See the date-fms documentation for more info.

<time>{{ createdAt | date('MM/dd/yyyy') }}</time>

There are some predefined formats that you can use:

Name	Format
ATOM	yyyy-MM-dd'T'HH:mm:ssxxx
DATE	yyyy-MM-dd
DATETIME	yyyy-MM-dd HH:mm:ss
TIME	HH:mm:ss
HUMAN_DATE	PPP
HUMAN_DATETIME	PPPppp

<time datetime="{{ createdAt | date }}">
  {{ createdAt | date('HUMAN_DATE') }}
</time>

On register the value you can edit or add more formats under a name, so it's more easy to apply them in the templates:

import date from "lume/plugins/date.js";

site.use(date({
  formats: {
    "MY_FORMAT": "MM-dd-yyyy",
  },
}));

Now you can use this format by its name:

<time>{{ createdAt | date('MY_FORMAT') }}</time>

Locales

date-fns has support for multiple locales. If you want to use them, just import and register them in _config.js:

import date from "lume/plugins/date.js";
import gl from "date_fns@v2.15.0/locale/gl/index.js";
import es from "date_fns@v2.15.0/locale/es/index.js";

site.use(date({
  locales: { gl, es },
}));

Use the second argument to set the locale used:

<time datetime="{{ createdAt | date }}">
  {{ createdAt | date('HUMAN_DATE', 'gl') }}
</time>

Note: The first locale set in the _config.js will be used also as the default locale.