woocommerce/plugins/woocommerce-admin/packages/date/README.md

# Date

A collection of utilities to display and work with date values.

## Installation

Install the module

```bash
pnpm install @woocommerce/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 ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods. Learn more about it in [Babel docs](https://babeljs.io/docs/en/next/caveats)._

## Usage

The `date` package makes use of the global `window.wcSettings.timeZone`.  If a timezone is set, the current and last periods will be converted from your browser's timezone to the store timezone.  If none is set, these periods will be based on your browser's timezone.
Try: Add Lerna to split out utility packages (https://github.com/woocommerce/woocommerce-admin/pull/678) * Add lerna & GB package-building script * Move currency library to lerna module * Update lerna config * Add publish commands * Add currency as an faux-external module * Add separate command to build just core files * Update dependency path * Update build script to build all packages into `dist` * Add packages to the jest test setup * Move date library to packages * Update imports to use @woocommerce/date * Output wcSettings definition before any scripts are output Fixes issues where wc-dates lib relies on settings object * Add the build step into travis * Update jest config to dynamically get package paths * Update package postcss config to match wc-admin’s main config * Add combined watch scripts for package+app, add a `clean` command to clean up old build files * Ignore PHPCS error (leave todo message to fix) * Concat files with a space, fix issue where all files join in one continuous string and fail the check 2018-10-30 18:57:48 +00:00			`# Date`

			`A collection of utilities to display and work with date values.`

			`## Installation`

			`Install the module`

			```bash
Switch to pnpm (https://github.com/woocommerce/woocommerce-admin/pull/8349) * Add pnpm-workspace.yaml * Add missing dependencies & replace file: with workspace:* in package.json * Replace "npm" with "pnpm" * Replace "npx" with "pnpx" * Remove package-lock.json * Add pnpm setup action to github workflows * Update webpack babel exclude path * Upgrade woo e2e and fix e2e test command Update e2e.yml Use pnpm run e2e:docker-up in e2e.yml * Remove unused docker-compose.yaml * Replace lerna with pnpm commands Update publish commands * Exclude _locutus_shared_bc.js in babel.config.js * Add .npmrc to set enable-pre-post-scripts=true by default * Fix storybook babel config Update babel.config.js * Add changelog * Update pnpm-lock.yaml * Replace pnpx with pnpm exec * Update pnpm-lock.yaml * Remove js-tests/package-lock.json * Fix @woocommerce/tracks -> workspace:* * Update pnpm-lock.yaml * Add @woocommerce/experimental to onboarding/package.json * Add "@woocommerce/component" to onboarding/package.json * Update pnpm-lock.yaml * Use \|\| instead of && for "test:watch" Co-authored-by: RJ <27843274+rjchow@users.noreply.github.com> * Fix packages/number "clean" command * Add root: true to .eslintrc.js to enforce it to use the root config file * Exclude packages/*/node_modules from babel transpiling Fix js-tests build config Co-authored-by: RJ <27843274+rjchow@users.noreply.github.com> 2022-03-04 04:01:16 +00:00			`pnpm install @woocommerce/date --save`
Try: Add Lerna to split out utility packages (https://github.com/woocommerce/woocommerce-admin/pull/678) * Add lerna & GB package-building script * Move currency library to lerna module * Update lerna config * Add publish commands * Add currency as an faux-external module * Add separate command to build just core files * Update dependency path * Update build script to build all packages into `dist` * Add packages to the jest test setup * Move date library to packages * Update imports to use @woocommerce/date * Output wcSettings definition before any scripts are output Fixes issues where wc-dates lib relies on settings object * Add the build step into travis * Update jest config to dynamically get package paths * Update package postcss config to match wc-admin’s main config * Add combined watch scripts for package+app, add a `clean` command to clean up old build files * Ignore PHPCS error (leave todo message to fix) * Concat files with a space, fix issue where all files join in one continuous string and fail the check 2018-10-30 18:57:48 +00:00			```

			`_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 ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods. Learn more about it in [Babel docs](https://babeljs.io/docs/en/next/caveats)._`

			`## Usage`
Try: Use the store timezone to make time data requests (https://github.com/woocommerce/woocommerce-admin/pull/6632) * Add store timezone string to preloaded settings * Get current timezone periods based on store timezone * Use current moment object to append timestamps * Add changelog and testing instructions * Consolidate timezone logic into getStoreCurrentTime * Use const for default datetime format * Use store moment converted via tz * Make testing instructions more clear * Add information to date readme about timezones * Add tests around getStoreTimeZoneMoment 2021-04-16 20:13:39 +00:00
Switch to pnpm (https://github.com/woocommerce/woocommerce-admin/pull/8349) * Add pnpm-workspace.yaml * Add missing dependencies & replace file: with workspace:* in package.json * Replace "npm" with "pnpm" * Replace "npx" with "pnpx" * Remove package-lock.json * Add pnpm setup action to github workflows * Update webpack babel exclude path * Upgrade woo e2e and fix e2e test command Update e2e.yml Use pnpm run e2e:docker-up in e2e.yml * Remove unused docker-compose.yaml * Replace lerna with pnpm commands Update publish commands * Exclude _locutus_shared_bc.js in babel.config.js * Add .npmrc to set enable-pre-post-scripts=true by default * Fix storybook babel config Update babel.config.js * Add changelog * Update pnpm-lock.yaml * Replace pnpx with pnpm exec * Update pnpm-lock.yaml * Remove js-tests/package-lock.json * Fix @woocommerce/tracks -> workspace:* * Update pnpm-lock.yaml * Add @woocommerce/experimental to onboarding/package.json * Add "@woocommerce/component" to onboarding/package.json * Update pnpm-lock.yaml * Use \|\| instead of && for "test:watch" Co-authored-by: RJ <27843274+rjchow@users.noreply.github.com> * Fix packages/number "clean" command * Add root: true to .eslintrc.js to enforce it to use the root config file * Exclude packages/*/node_modules from babel transpiling Fix js-tests build config Co-authored-by: RJ <27843274+rjchow@users.noreply.github.com> 2022-03-04 04:01:16 +00:00			The `date` package makes use of the global `window.wcSettings.timeZone`. If a timezone is set, the current and last periods will be converted from your browser's timezone to the store timezone. If none is set, these periods will be based on your browser's timezone.