bizday
これはbizday(=営業日)を操作するライブラリです。
bd = new bizday('2018-05-01')
bd.val() // '2018-05-01'
bd.add() // '2018-05-02'
bd.sub() // '2018-05-01'
bd.val() // '2018-05-01'
constructor
date opts
date (string)
日付の初期値を設定します。'2018-01-01','20180101'といった形式が使用できます。省略すると現在の日付になります。
var bd;bd = ;bd; // '現在の日付'bd; // '翌営業日の日付;
var bd;bd = '20180101';bd // '2018-01-01'bd // '2018-01-02'
var bd;bd = '2018-01-01';bd// '2018-01-01'bd// '2018-01-02'
opts.format
出力するformatを指定します。formatはMoment.jsに準拠します。
Moment.js | Docs
var bd;bd = '2018-01-01' format: '';bd // '2018-01-01T00:00:00+09:00'bd // '2018-01-02T00:00:00+09:00'
var bd;bd = '2018-01-01' format: 'YYYYMMDD';bd // '20180101'bd // '20180102'
opts.type
このオプションをつけない場合、営業日は土日以外となります。しかし実際には祝日も営業していない事が多いので、type
オプションを設定する事で祝日を考慮した営業日を使用できます。
type: 'jp'
日本の祝日を考慮します。元旦は祝日ですが1月2日は平日の場合営業日になります。
type: 'go'
日本の官公庁の営業日です。土日と祝日、12月29日から1月3日までを除いた日になります。
参考: 行政機関の休日に関する法律
type: 'tse'
東京証券取引所の営業日です。土日と祝日、12月31日から1月3日までを除いた日になります。
var bd;bd = '2017-12-31' type: 'jp';bd // '2017-12-31'bd // '2018-01-02'
opts.reject
営業日から除外する日付を指定します。文字列または正規表現が使用できます。
文字列の場合、内部ではString.prototype.includes()
で判定しています。
var bd;bd = '2018-01-01' reject: '-01-02';bd // '2018-01-01'bd // '2018-01-03'
例えば1月2日を除外したい場合に'01-02'
とすると、〇〇01年02月
も全て除外されるので注意が必要です。
var bd;bd = '2018-01-01' reject: /\d{4}-01-\d{2}/;bd // '2018-01-01'bd // '2018-02-01'
複数指定する場合は配列に格納します。
var bd;bd = '2018-01-01' reject: /\d{4}-01-\d{2}/ '-02-01' ;bd // '2018-01-01'bd // '2018-02-02'
method
val()
インスタンスが保持している日付を返します。
var bd;bd = '2018-01-01';bd// '2018-01-01'
add(count)
日付を進めて更新し、その日付を返します。 引数を省略した場合、翌営業日に更新します。
var bd;bd = '2018-07-02';bd// '2018-07-02'bd// '2018-07-03'
引数として日数xを指定するとx営業日後の日付に更新します。
var bd;bd = '2018-07-02' type: 'jp';bd // '2018-07-24'
sub(count)
日付を戻して更新し、その日付を返します。 引数を省略した場合、前営業日に更新します。
var bd;bd = '2018-07-02';bd// '2018-07-02'bd// '2018-06-29'
引数として日数xを指定するとx営業日前の日付に更新します。
var bd;bd = '2018-07-24' type: 'jp';bd // '2018-07-02'
warning
- 対応しているのは2000-01-01から2030-12-31の間だけです。範囲を超えると例外をthrowします。
- 未来の祝日に関しては変わる可能性があります。
thanks
祝日のデータに関してはこちらからお借りしています。
holiday-jp/holiday_jp-ruby: Japanese holiday.