Dates

relativeTime

Human time, with a caller-controlled clock.

Use it in your component

Standalone component

import { Component } from '@angular/core';
import { RelativeTimePipe } from 'extra-pipe';

@Component({
  standalone: true,
  imports: [RelativeTimePipe],
  template: `{{ publishedAt | relativeTime: referenceTime: 'en' }}`,
})
export class ExampleComponent {
readonly publishedAt = new Date('2024-01-01T12:03:00Z');
  readonly referenceTime = new Date('2024-01-01T12:00:00Z');
}

Template

{{ publishedAt | relativeTime: referenceTime: 'en' }}

Try it live.

The output below runs the packed library. Edit data, not code.

Input (JSON)Use double quotes for text, or a number, array, object or null.

Parameters (JSON array)Ordered parameters: referenceTime. Locale is controlled separately.

Output localeApplied to the live output.

Live template data

readonly value = "2024-01-01T12:03:00Z";
readonly parameter0 = "2024-01-01T12:00:00Z";
{{ value | relativeTime: parameter0: "en-US" }}

Rendered output

in 3 minutes

Update the reference-time parameter to refresh this output. This pipe does not start a timer.