Introduction

NVDate is a Swift Date utility library, created to make date and time manipulation easier.

Features

A lot of API functions to make date and time manipulation easier and fun
Self-explanatory & intuitive naming convention
NVDate functions are chainable
Easy to use
Open Source!

Installation

◉ Using Swift Package Manager

Add this package URL in Xcode or your Package.swift:

.package(url: "https://github.com/novalagung/NVDate.git", from: "3.0.0")

Then add NVDate as a dependency of your target and import it:

import NVDate

◉ Using CocoaPods

Swift Package Manager is the recommended installation path for NVDate 3.0.0 and newer. CocoaPods support is kept for existing projects.

Add these into your Podfile:

pod 'NVDate', :git => 'https://github.com/novalagung/NVDate.git', :tag => '3.0.0'

Then import NVDate into your Swift file.

import NVDate

Legacy Objective-C

Add these into your Podfile:

pod 'NVDate', :git => 'https://github.com/novalagung/NVDate.git', :tag => '1.0.1'

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

#import "NVDate.h"

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

◉ Types

Type	Values
`NVDate.DayName`	`.sunday`, `.monday`, `.tuesday`, `.wednesday`, `.thursday`, `.friday`, `.saturday`
`NVDate.MonthName`	`.january`, `.february`, `.march`, `.april`, `.may`, `.june`, `.july`, `.august`, `.september`, `.october`, `.november`, `.december`

◉ Initializers

Initializer	Description
`NVDate()`	Constructs an instance using the current date and time.
`NVDate(fromString: String, withFormat: String)`	Constructs an instance by parsing a string with an explicit date format.
`NVDate(year: Int, month: Int, day: Int)`	Constructs an instance from year, month, and day components.
`NVDate(year: Int, month: Int, day: Int, hour: Int, minute: Int, second: Int)`	Constructs an instance from full date and time components.
`NVDate(fromDate: Date)`	Constructs an instance from an existing `Date`.
`NVDate(fromTimeIntervalSinceReferenceDate: TimeInterval)`	Constructs an instance from a Foundation reference-date time interval.

◉ Formatting and Configuration

Method	Return	Description
`date()`	`Date?`	Returns the underlying date value.
`asString()`	`String`	Formats the date using the configured formatter.
`asString(withFormat: String)`	`String`	Formats the date using the provided date format.
`dateFormat()`	`String`	Returns the formatter's current date format.
`dateFormat(setFormat: String)`	`Void`	Sets the formatter's date format.
`dateStyle()`	`DateFormatter.Style`	Returns the formatter's date style.
`dateStyle(setStyle: DateFormatter.Style)`	`Void`	Sets the formatter's date style.
`timeStyle()`	`DateFormatter.Style`	Returns the formatter's time style.
`timeStyle(setStyle: DateFormatter.Style)`	`Void`	Sets the formatter's time style.
`timeZone()`	`TimeZone`	Returns the configured time zone.
`timeZone(setTimeZone: TimeZone)`	`Void`	Sets the time zone used by the formatter and calendar.

◉ Date Arithmetic

Method	Return	Description
`setTimeAsZero()`	`NVDate`	Sets hour, minute, and second to `0`.
`nextDays(days: Int)`	`NVDate`	Moves the date forward by the provided number of days.
`nextDay()`	`NVDate`	Moves the date forward by one day.
`tomorrow()`	`NVDate`	Alias of `nextDay()`.
`previousDays(diff: Int)`	`NVDate`	Moves the date backward by the provided number of days.
`previousDay()`	`NVDate`	Moves the date backward by one day.
`yesterday()`	`NVDate`	Alias of `previousDay()`.
`nextWeeks(diff: Int)`	`NVDate`	Moves the date forward by the provided number of weeks.
`nextWeek()`	`NVDate`	Moves the date forward by one week.
`previousWeeks(diff: Int)`	`NVDate`	Moves the date backward by the provided number of weeks.
`previousWeek()`	`NVDate`	Moves the date backward by one week.
`nextMonths(diff: Int)`	`NVDate`	Moves the date forward by the provided number of months.
`nextMonth()`	`NVDate`	Moves the date forward by one month.
`previousMonths(diff: Int)`	`NVDate`	Moves the date backward by the provided number of months.
`previousMonth()`	`NVDate`	Moves the date backward by one month.
`nextYears(diff: Int)`	`NVDate`	Moves the date forward by the provided number of years.
`nextYear()`	`NVDate`	Moves the date forward by one year.
`previousYears(diff: Int)`	`NVDate`	Moves the date backward by the provided number of years.
`previousYear()`	`NVDate`	Moves the date backward by one year.
`firstDayOfMonth()`	`NVDate`	Moves the date to the first day of its current month.
`lastDayOfMonth()`	`NVDate`	Moves the date to the last day of its current month.
`firstMonthOfYear()`	`NVDate`	Moves the date to January of its current year.
`lastMonthOfYear()`	`NVDate`	Moves the date to December of its current year.
`nearestPreviousDay(_ dayName: NVDate.DayName)`	`NVDate`	Moves the date to the nearest previous matching weekday.
`nearestNextDay(_ dayName: NVDate.DayName)`	`NVDate`	Moves the date to the nearest next matching weekday.

◉ Date Information

Method	Return	Description
`thisDayName()`	`NVDate.DayName`	Returns the weekday name for the current date value.
`todayName()`	`NVDate.DayName`	Alias of `thisDayName()`.
`isThisDayName(_ dayName: NVDate.DayName)`	`Bool`	Returns whether the date's weekday matches the provided weekday.
`isTodayName(_ dayName: NVDate.DayName)`	`Bool`	Alias of `isThisDayName(_:)`.
`thisMonthName()`	`NVDate.MonthName`	Returns the month name for the current date value.
`isThisMonthName(_ monthName: NVDate.MonthName)`	`Bool`	Returns whether the date's month matches the provided month.
`year()`	`Int`	Returns the year component.
`year(setYear: Int)`	`Void`	Sets the year component.
`month()`	`Int`	Returns the month component.
`month(setMonth: Int)`	`Void`	Sets the month component.
`weekOfYear()`	`Int`	Returns the week-of-year component.
`weekOfMonth()`	`Int`	Returns the week-of-month component.
`day()`	`Int`	Returns the day component.
`day(setDay: Int)`	`Void`	Sets the day component.
`hour()`	`Int`	Returns the hour component.
`hour(setHour: Int)`	`Void`	Sets the hour component.
`minute()`	`Int`	Returns the minute component.
`minute(setMinute: Int)`	`Void`	Sets the minute component.
`second()`	`Int`	Returns the second component.
`second(setSecond: Int)`	`Void`	Sets the second component.

Contribution

Feel free to contribute by doing fork -> pull request

License

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

Name		Name	Last commit message	Last commit date
Latest commit History 82 Commits
.github/workflows		.github/workflows
Examples/iOSExample		Examples/iOSExample
Tests/NVDateTests		Tests/NVDateTests
.gitignore		.gitignore
.travis.yml		.travis.yml
LICENSE		LICENSE
NVDate.podspec		NVDate.podspec
NVDate.swift		NVDate.swift
Package.swift		Package.swift
README.md		README.md
coverage.json		coverage.json
test.sh		test.sh

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Introduction

Features

Installation

◉ Using Swift Package Manager

◉ Using CocoaPods

Legacy Objective-C

Example

◉ Today date as string

◉ Date 2018/05/25 as string

◉ Last day of next 2 months

◉ Second week of 2 months ago

◉ Detect if 2018/05/25 is friday

◉ Dot syntax

API Documentation

◉ Types

◉ Initializers

◉ Formatting and Configuration

◉ Date Arithmetic

◉ Date Information

Contribution

License

About

Uh oh!

Releases 1

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

Introduction

Features

Installation

◉ Using Swift Package Manager

◉ Using CocoaPods

Legacy Objective-C

Example

◉ Today date as string

◉ Date 2018/05/25 as string

◉ Last day of next 2 months

◉ Second week of 2 months ago

◉ Detect if 2018/05/25 is friday

◉ Dot syntax

API Documentation

◉ Types

◉ Initializers

◉ Formatting and Configuration

◉ Date Arithmetic

◉ Date Information

Contribution

License

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 1

Uh oh!

Contributors

Uh oh!

Languages