react-fromnow v4.2.0

react-fromnow

React component for display time from now

Language support: English, Українська, Русский

Installing

npm install react-fromnow
# or
yarn add react-fromnow

Basic usage

Below examples assumes Date.now() is 1556026229910

import React from 'react';
import ReactDOM from 'react-dom';
import Fromnow from 'react-fromnow';

ReactDOM.render(
  <Fromnow date={Date.now()} />,
  document.getElementById('root')
);

<time dateTime="2019-04-23T13:30:29.910Z">
  just now
</time>

Set tag

By default use tag <time> MDN

<Fromnow tag="span" date={Date.now() - (1000 * 60 * 60)} />

<span data-datetime="2019-04-23T12:30:29.910Z">
  1 hour ago
</span>

No tag

Set false expression false | "" or null and component return just string.

<Fromnow tag={false} date={Date.now() + (1000 * 60 * 60)} />

"1 hour from now"

Set attributes

<Fromnow className="from__now" date={Date.now() - (1000 * 60 * 60 * 2)} />

<time class="from__now" dateTime="2019-04-23T11:30:29.910Z">
  2 hours ago
</time>

Language support

Create language modifier

import React from 'react';
import ReactDOM from 'react-dom';

import Fromnow, { ua } from 'react-fromnow';

const lang = ua();
const date = Date.now() - (1000 * 60 * 60 * 2);

ReactDOM.render(
  <Fromnow date={date} lang={lang} />,
  document.getElementById('root')
);

<time dateTime="2019-04-23T11:30:29.910Z">
  2 години тому назад
</time>

Language configuration

Use the %% key to insert date.

import Fromnow, { en } from 'react-fromnow';

const lang = en({
  now: 'just now',
  was: '%% AGO!!!', // changed
  will: '%% from now',
});

const date = Date.now() - (1000 * 60 * 60 * 5);

<Fromnow date={date} lang={lang} />

<time dateTime="2019-04-23T08:30:29.910Z">
  5 hours AGO!!!
</time>

default

Use createFromnow()

import { createFromnow } from 'react-fromnow';

// initialized
const fromnow = createFromnow();

// english default
fromnow(Date.now() - (1000 * 60 * 60 * 4)); // "4 hours ago"

language

import { createFromnow, ru } from 'react-fromnow';

// initialized
const fromnow = createFromnow(ru);

fromnow(Date.now() + (1000 * 60 * 4)); // "через 4 минуты"

with options

import { createFromnow, ua } from 'react-fromnow';

// initialized
const fromnow = createFromnow(ua, {
  now: 'саме зараз', // changed
  was: '%% тому назад',
  will: 'через %%',
});

fromnow(Date.now()); // "саме зараз"

License

MIT