Skip to content
🌏 It's a lib which let you to transfer human time to computer-readable time and also to transfer computer-generated time to human time, available for English and Chinese words.
JavaScript
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode
src
.gitattributes
.gitignore
.npmignore
.npmrc
.yarnclean
CNAME
LICENSE
README.md
_config.yml
index.js
package.json
test.js
yarn.lock

README.md

node-shi(时)

It's a lib which let you to transfer human time to computer-readable time and also to transfer computer-generated time to human time, available for English and Chinese.

NPM Package | CNPM

How to use

# npm
npm i node-shi

# yarn
yarn add node-shi
var shi = require('node-shi');

// human time -> time in Arabic number as seconds
console.log(shi.humanTimeParser("five hundreds and twenty one seconds"));//521
console.log(shi.humanTimeParser("a day and 一 hour, 52 min 16sec"));//93136
console.log(shi.humanTimeParser("三十三分钟", { to: "m" }));//33
shi.setDefault({ as: 'm' });//set default
console.log(shi.humanTimeParser("50", { to: 'h' }))//0.8333333333333334
console.log(shi.humanTimeParser("50", { as: 'h', to: 'm' }))//3000
shi.clearDefault();//clear defaults
console.log(shi.humanTimeParser("badstring", { ignoreError: true }))//badstring (because errors ignored)

// unit convert
console.log(shi.unitConverter(60, 'm', 'h'));//1
console.log(shi.unitConverter(1, "d", "ms"));//86400000

// time in Arabic number -> human time
console.log(shi.ArabicNumberTimeParser(1500));//25 minutes
console.log(shi.ArabicNumberTimeParser(36, { lang: 'fr', to: 'h' }));//0,01 heure
console.log(shi.ArabicNumberTimeParser(1, { lang: 'zh_CN', as: 'ms', to: 's', round: true }));//0 秒
console.log(shi.ArabicNumberTimeParser(NaN, { ignoreError: true }))//0 seconds (because errors ignored)

// output the version
console.log(shi.version());//0.4.1

Features

Human time -> time in Arabic number

  • Chinese number + Chinese unix -> time in Arabic number as seconds
  • Chinese number + English unix -> time in Arabic number as seconds
  • Arabic number + Chinese unix -> time in Arabic number as seconds
  • Arabic number + English unix -> time in Arabic number as seconds
  • English number + Chinese unix -> time in Arabic number as seconds
  • English number + English unix -> time in Arabic number as seconds

Time in Arabic number -> Human time

  • Time with units d, h, m (min), s, ms to human time in languages including: 'ar', 'bg', 'ca', 'cs', 'da', 'de', 'el', 'en', 'es', 'et', 'fa', 'fi', 'fo', 'fr', 'hr', 'hu', 'id', 'is', 'it', 'ja', 'ko', 'lo', 'lt', 'lv', 'ms', 'nl', 'no', 'pl', 'pt', 'ro', 'ru', 'uk', 'ur', 'sk', 'sv', 'tr', 'th', 'vi', 'zh_CN', 'zh_TW'.

Time unix translate

  • Arabic number in different unixs d, h, m (min), s, ms -> time in Arabic number as d, h, m (min), s, ms

Future of this project

For the future of node-shi, go to the todo-list.

Packages Using

  • js-pinyin, waterchestnet, MIT License.
  • timestring, mike182uk, MIT License.
  • chinese-numbers-converter, anton-bot, MIT License.
  • english2number, TSavo, MIT License.
  • HumanizeDuration.js, EvanHahn, Unlicense.
You can’t perform that action at this time.