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

@reuters-graphics/d3-locale

Package Overview
Dependencies
Maintainers
4
Versions
10
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@reuters-graphics/d3-locale

D3 localization shortcut for Reuters graphics

  • 2.0.0
  • latest
  • npm
  • Socket score

Version published
Weekly downloads
9
decreased by-10%
Maintainers
4
Weekly downloads
 
Created
Source

@reuters-graphics/d3-locale

Easy translation for d3 charting.

Covers the following locales:

  • en: US English
  • de: German
  • es: Spanish
  • fr: French
  • it: Italian
  • ja: Japanese
  • pt: Portuguese
  • zh: Chinese

Install

yarn add @reuters-graphics/d3-locale d3-format d3-time-format d3-time

Use

import D3Locale from '@reuters-graphics/d3-locale';

const locale = new D3Locale('de');

// Use it alone...
locale.format(',')(23000);
// '23.000'
locale.formatTime('%B %d')(new Date('2020-07-13'));
// 'Juli 13'

// ... or with an axis
d3.axisBottom(xScale)
  .tickFormat(locale.formatTime('%b. %d, %Y'));

// Can also override a part of a locale specifier...
locale.format('$')(12.2)
// R$12,2
locale.formatSpecifier = { currency: ['', '€'] };
locale.format('$')(12.2)
// '12,2€'

Extra features

AP-style dates

You can set the formatter to use AP-style month abbreviations in English.

const locale = new D3Locale('en');
locale.apStyle();
locale.formatTime('%b %d, %Y')(new Date('2020-03-13'));
// March 13, 2020
locale.formatTime('%b %d, %Y')(new Date('2020-01-13'));
// Jan. 13, 2020
Time multiformat

By default, d3 time scales use a multi-scale time format. You can recreate this using your locale and pass it to an axis' tickFormat method.

const locale = new D3Locale('en');

const timeScale = d3.timeScale().domain([ /* ... */ ]);

d3.axisBottom(timeScale)
  .tickFormat(locale.timeMultiFormat());

// Example formats...
locale.timeMultiFormat()(new Date('2020-01-01'));
// 2020
locale.timeMultiFormat()(new Date('2020-02-01'));
// February
locale.timeMultiFormat()(new Date('2020-02-02'));
// Feb 02

You can also customize the component formatters used in the multi-scale time formatter. For example, our preferred formatter for AP-style date series:

locale.apStyle();
locale.timeMultiFormat({ month: '%b', week: '%b %-e' })(new Date('2020-01-01'));
// 2020
locale.timeMultiFormat({ month: '%b', week: '%b %-e' })(new Date('2020-02-01'));
// Feb.
locale.timeMultiFormat({ month: '%b', week: '%b %-e' })(new Date('2020-02-02'));
// Feb. 2
Japanese/Chinese myriad groupings

There is special handling for decimal notation with an SI prefix (s format) in Japanese and Chinese in order to handle grouping by myriads rather than thousands.

const locale = new D3Locale('ja');
locale.format(',s')(16000);
// 1.6万
locale.format(',s')(25000000);
// 2,500万
locale.format('$,s')(1233000);
// 123.3万円

FAQs

Package last updated on 12 Nov 2021

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