caldate

caldate

calendar date for date-holidays

Table of Contents

• Class: CalDate
  • new CalDate(opts)
  • CalDate.set(opts)
  • CalDate.isEqualDate(calDate)
  • CalDate.getDay()
  • CalDate.setOffset(number, unit)
  • CalDate.setTime(hour, minute, second)
  • CalDate.setDuration(duration)
  • CalDate.update()
  • CalDate.toEndDate()
  • CalDate.toTimezone(timezone)
  • CalDate.toDate()
  • CalDate.toISOString()
  • CalDate.toString()
• Contribution and License Agreement
• License
• References

Class: CalDate

new CalDate(opts)

constructs a new CalDate instance

Parameters

opts: Object | Date, See set(opts)

Example:

// ES5
import CalDate from 'caldate'
// cjs
const CalDate = require('caldate')

const caldate = new CalDate('2000-01-01 12:00:00')
caldate.year
//> 2000
caldate.month
//> 1

CalDate.set(opts)

set calendar date

Parameters

opts: Object | Date, defaults to 1900-01-01

opts.year: String, set calendar date

opts.month: String, January equals to 1, December to 12

opts.day: String, set calendar date

opts.hour: String, set calendar date

opts.minute: String, set calendar date

opts.second: String, set calendar date

opts.duration: String, defaults to 24 hours

CalDate.isEqualDate(calDate)

checks if Date is equal to calDate

Parameters

calDate: CalDate, checks if Date is equal to calDate

Returns: Boolean, true if date matches

CalDate.getDay()

get day of week

Returns: Number, day of week 0=sunday, 1=monday, ...

CalDate.setOffset(number, unit)

set offset per unit

Parameters

number: Number, set offset per unit

unit: String, Unit in days d, hours h, minutes m`

Returns: Object, this

CalDate.setTime(hour, minute, second)

set time per hour, minute or second while maintaining duration at midnight

Parameters

hour: Number, set time per hour, minute or second while maintaining duration at midnight

minute: Number, set time per hour, minute or second while maintaining duration at midnight

second: Number, set time per hour, minute or second while maintaining duration at midnight

Returns: Object, this

CalDate.setDuration(duration)

set duration in hours

Parameters

duration: Number, in hours

Returns: Object, this

CalDate.update()

update internal data to real date

Returns: Object, this

CalDate.toEndDate()

get end date of calendar date

Returns: CalDate

CalDate.toTimezone(timezone)

move internal date to a date in timezone

Parameters

timezone: String, e.g. 'America/New_York'

Returns: Date

CalDate.fromTimezone(dateUTC, timezone)

set date from a given timezone

Parameters

dateUTC: Date, date in UTC

timezone: String, timezone of dateUTC, e.g. 'America/New_York'

Returns: CalDate self

CalDate.toDate()

convert to Date

Returns: Date

CalDate.toISOString()

get Date in ISO format

CalDate.toString()

get Date as String YYYY-MM-DD HH:MM:SS

Contribution and License Agreement

If you contribute code to this project, you are implicitly allowing your code to be distributed under the ISC license. You are also implicitly verifying that all code is your original work or correctly attributed with the source of its origin and licence.

License

Copyright (c) 2016 commenthol (ISC License)

See LICENSE for more information.

References

• LICENSE