Introduction

NVDate is an extension of NSDate class (Swift4), created to make date and time manipulation easier. NVDate is testable and robust, we wrote intensive test to make sure everything is safe.

Features

Has lot of API function to make date and time manipulation easier and fun
Has user friendly naming convention
NVDate functions are chainable
Very easy to use
Open Source!

Installation

Using Cocoa Pods

Swift4

Add these into your Podfile:

pod 'NVDate', '2.0.1'

Then import NVdate into your swift file.

import NVDate

Objective-C

Add these into your Podfile:

pod 'NVDate', '1.0.0'

Then import NVdate.h into your .h or .m file.

#import "NVDate.h"

Simple Example

Today date as string

let date = NVDate()

print(date.asString())
// ==> Wednesday, February 5, 2014, 4:56:35 PM Western Indonesia Time

Date 2018/05/25 as string

let date = NVDate(fromString: "2018/05/25", withFormat: "yyyy/MM/dd")

print(date.asString())
// ==> Friday, May 25, 2018, 00:00:00 AM Western Indonesia Time

Last day of next 2 months

let date = NVDate()
    .nextMonths(diff: 2)
    .lastDayOfMonth()

print(date.asString(withFormat: "dd-MM-yyyy"))
// ==> 30-04-2014

Second week of 2 months ago

let date = NVDate()
    .previousMonths(diff: 2)
    .firstDayOfMonth()
    .nextWeek()
date.dateFormat(setFormat: "yyyy-MM-dd HH:mm:ss")

print(date.asString())
// ==> 2013-12-08 17:03:36

Detect if 2018/05/25 is friday

let todayIsFriday = NVDate(year: 2018, month: 5, day: 25)
    .previousDay()
    .isTodayName(.friday)

print(todayIsFriday)
// ==> false

Dot syntax

let someday = NVDate()
    .previousDay()
    .previousWeek()
    .nextDay()
    .asString()

print(someday)
// ==> 2013-12-08 17:03:36

API Documentation

Initialization

Initialization	Description
`NVDate()`	Today date is used as date value
`NVDate(fromString:withFormat:)`	Use specified date string as date value. Format of specified date string has to be explicitly defined.
`NVDate(year:month:day:)`	Construct new date using year, month, and day
`NVDate(year:month:day:hour:minute:second:)`	Construct new date using year, month, day, hour, minute, second
`NVDate(fromDate:)`	use specified date as value

Methods

Method	Description
`date()`	return the date object
`asString()`	return string formatted of date object
`asString(withFormat:)`	return formatted string value of date object. the format has to be defined explicitly
`setTimeAsZero()`	set hour, minute, and second as 0
`dateFormat()`	return the current date format. the format is used on `asString()`
`dateFormat(setFormat:)`	change current date format. the format is used on `asString()`
`dateStyle()`	return the date style of current formatter
`dateStyle(setStyle:)`	change date style of current formatter
`timeStyle()`	return the time style of current formatter
`timeStyle(setStyle:)`	change time style of current formatter
`timeZone()`	return current timezone value
`timeZone(setTimeZone:)`	change the timezone value
`nextDays(days:)`	move to next x days
`nextDay()`	move to next day
`tomorrow()`	alias of `nextDay()`
`previousDays(days:)`	move to previous x days
`previousDay()`	move to previous day
`yesterday()`	alias of `previousDay()`
`nextWeek()`	move to next week
`nextWeeks(diff:)`	move to next x weeks
`previousWeek()`	move to previous week
`previousWeeks(diff:)`	move to previous x weeks
`nextMonth()`	move to next month
`nextMonths(diff:)`	move to next x months
`previousMonth()`	move to previous month
`previousMonths(diff:)`	move to previous x months
`nextYear()`	move to next year
`nextYears(diff:)`	move to next x years
`previousYear()`	move to previous year
`previousYears(diff:)`	move to previous x years
`firstDayOfMonth()`	move to first day of current month
`lastDayOfMonth()`	move to last day of current month
`firstMonthOfYear()`	move to first month of current year
`lastMonthOfYear()`	move to last month of current year
`nearestPreviousDay(_:)`	move to x previous day that name equal to `NVDate.DayName`
`nearestNextDay(_:)`	move to x next day that name equal to `NVDate.DayName`
`thisDayName()`	get today day name, in type `NVDate.DayName`
`todayName()`	alias of `thisDayName()`
`isThisDayName(_:)`	return true if specified day name is equal with day on the object
`isTodayName(_:)`	alias of `isThisDayName(_:)`
`thisMonthName()`	get this month name, in type `NVDate.MonthName`
`isThisMonthName(_:)`	return true if specified month name is equal with month on the object
`year()`	return year value
`year(setYear:)`	change year value
`month()`	return month value
`month(setMonth:)`	change month value
`weekOfYear()`	return week of year value
`weekOfMonth()`	return week of month value
`day()`	return day value
`day(setDay:)`	change day value
`hour()`	return hour value
`hour(setHour:)`	change hour value
`minute()`	return minute value
`minute(setMinute:)`	change minute value
`second()`	return second value
`second(setSecond:)`	change second value

Contribution

Feel free to contribute by doing fork -> pull request

License

http://novalagung.mit-license.org/

novalagung/nvdate

novalagung

Reviews

Repository Details