Skip to main content

Modifier :human

:human does different things on different tags and fields:

  • Relative date on {date_created}, {date_updated}, and {payment_date}, under What to show in the picker.
    Example: {date_created:human} gives 3 hours ago.
  • Relative time on Date and Time fields, under Change the output in the picker.
    Example: {Start Date:128:human} gives 2 months from now. On the test form, this field is {Start Date:128} (Date).

Relative date

Shows as "3 hours ago" for the first 24 hours, then as a date. diff is always relative.

ProductGravity Forms
RequiresGravity Forms 1.9 or later
In the pickerWhat to show, for {date_created}, {date_updated}, and {payment_date}

Examples

Output from the real plugin code, run on a test entry.

Merge tagOutputWithout the modifier
{date_created:human}3 hours agoJanuary 15, 2026
{date_updated:human}3 hours agoJanuary 15, 2026
{payment_date:human}3 hours agoJanuary 15, 2026
{date_created:human}

Rendered against an entry nine days older, where the result differs.

January 13, 2026January 15, 2026
{date_updated:human}

Rendered against an entry nine days older, where the result differs.

January 13, 2026January 15, 2026
{payment_date:human}

Rendered against an entry nine days older, where the result differs.

January 13, 2026January 15, 2026

Works on

Merge tags: {date_created} · {date_updated} · {payment_date}.

Relative time

Always relative, like "3 days ago", unlike {date_created:human}. Date and Time fields only.

Works in any merge tag while GravityView is active, including Gravity Forms notifications.

ProductGravityView
RequiresGravityView 2.29 or later
In the pickerChange the output, for Date and Time fields

How to use it

Say how long ago a date was

Write

Born {Birthday:13:human}

Get

Born 47 years ago

Examples

Output from the real plugin code, run on a test entry.

Merge tagOutputWithout the modifier
{Birthday:13:human}47 years ago04/27/1979

Works on

Form fields: Date · Time.

Left out

Field kindsWhy
Date, after a custom formatLocked there. "Custom date format" already reads the value as a date. A second date step would read its result instead of the field’s value and give a wrong date. Remove it first.