Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@wordpress/date

Package Overview
Dependencies
Maintainers
25
Versions
164
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@wordpress/date

Date module for WordPress.

  • 4.42.4
  • Source
  • npm
  • Socket score

Version published
Maintainers
25
Created
Source

Date

Date module for WordPress.

Installation

Install the module

npm install @wordpress/date --save

This package assumes that your code will run in an ES2015+ environment. If you're using an environment that has limited or no support for such language features and APIs, you should include the polyfill shipped in @wordpress/babel-preset-default in your code.

API

date

Formats a date (like date() in PHP).

Related

Parameters

  • dateFormat string: PHP-style formatting string. See php.net/date.
  • dateValue Moment | Date | string | undefined: Date object or string, parsable by moment.js.
  • timezone string | number | undefined: Timezone to output result in or a UTC offset. Defaults to timezone from site.

Returns

  • string: Formatted date in English.

dateI18n

Formats a date (like wp_date() in PHP), translating it into site's locale.

Backward Compatibility Notice: if timezone is set to true, the function behaves like gmdateI18n.

Related

Parameters

  • dateFormat string: PHP-style formatting string. See php.net/date.
  • dateValue Moment | Date | string | undefined: Date object or string, parsable by moment.js.
  • timezone string | number | boolean | undefined: Timezone to output result in or a UTC offset. Defaults to timezone from site. Notice: boolean is effectively deprecated, but still supported for backward compatibility reasons.

Returns

  • string: Formatted date.

format

Formats a date. Does not alter the date's timezone.

Parameters

  • dateFormat string: PHP-style formatting string. See php.net/date.
  • dateValue Moment | Date | string | undefined: Date object or string, parsable by moment.js.

Returns

  • string: Formatted date.

getDate

Create and return a JavaScript Date Object from a date string in the WP timezone.

Parameters

  • dateString string?: Date formatted in the WP timezone.

Returns

  • Date: Date

getSettings

Returns the currently defined date settings.

Returns

  • DateSettings: Settings, including locale data.

gmdate

Formats a date (like date() in PHP), in the UTC timezone.

Parameters

  • dateFormat string: PHP-style formatting string. See php.net/date.
  • dateValue Moment | Date | string | undefined: Date object or string, parsable by moment.js.

Returns

  • string: Formatted date in English.

gmdateI18n

Formats a date (like wp_date() in PHP), translating it into site's locale and using the UTC timezone.

Parameters

  • dateFormat string: PHP-style formatting string. See php.net/date.
  • dateValue Moment | Date | string | undefined: Date object or string, parsable by moment.js.

Returns

  • string: Formatted date.

humanTimeDiff

Returns a human-readable time difference between two dates, like human_time_diff() in PHP.

Parameters

  • from Moment | Date | string: From date, in the WP timezone.
  • to Moment | Date | string | undefined: To date, formatted in the WP timezone.

Returns

  • string: Human-readable time difference.

isInTheFuture

Check whether a date is considered in the future according to the WordPress settings.

Parameters

  • dateValue string: Date String or Date object in the Defined WP Timezone.

Returns

  • boolean: Is in the future.

setSettings

Adds a locale to moment, using the format supplied by wp_localize_script().

Parameters

  • dateSettings DateSettings: Settings, including locale data.

Contributing to this package

This is an individual package that's part of the Gutenberg project. The project is organized as a monorepo. It's made up of multiple self-contained software packages, each with a specific purpose. The packages in this monorepo are published to npm and used by WordPress as well as other software projects.

To find out more about contributing to this package or Gutenberg as a whole, please read the project's main contributor guide.



Code is Poetry.

Keywords

FAQs

Package last updated on 09 Oct 2023

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc