Swiftpack.co - Package - malcommac/SwiftDate

SwiftDate

Carthage compatible CI Status Version License Platform

We really ♥ Swift and we think that dates and timezones management should be painless: this is the reason we made SwiftDate, probably the best way to manage date and time in Swift.

Choose SwiftDate for your next project, or migrate over your existing projects—you'll be happy you did!

★★ Star our github repository to help us! ★★

Created by Daniele Margutti (@danielemargutti)

Swift 3 and Swift 4 Compatibility

  • Swift 4.x: >= 4.4.0 - Latest is 4.5.1 Download here (pod 'SwiftDate')
  • Swift 3.x: Latest compatible version is 4.3.0 Download here. If you are using CocoaPods be sure to fix the release (pod 'SwiftDate', '~> 4.3.0')

Main features

Here's a highlight of the main features you can find in SwiftDate:

  • Simple math operations with dates! Example: aDate + 2.weeks + 1.hour or (1.year - 2.hours + 16.minutes).fromNow()
  • Easy conversions to and from timezone, locale and calendar. Use the helper class DateInRegion and perform conversions with components and operations!
  • Compare dates with math operators <,>,==,<=,>=. For example, you can do aDate1 >= aDate2 or aDate1.isIn(anotherDate,.day)
  • Easily work with time components. E.g. aDateInRegion.day or hour, minutes etc. expressed in your favourite timezone!
  • Easy and optimized way to get and transform a date from and to strings: supports both colloquial (human readable) and fixed formats (ISO8601, AltRSS, RSS, Extended, .NET and custom string as per Unicode standard)
  • Express time interval in other time units; for example 120.seconds.in(.minutes) // 2 minutes
  • Many shortcuts to get intervals, work with time units, intervals and common date operations (isYesterday,isTomorrow,isBefore()...)
  • ... many many other shiny things!

OTHER LIBRARIES YOU MAY LIKE

I'm also working on several other projects you may like. Take a look below:

| Library | Description | |-----------------|--------------------------------------------------| | SwiftDate | The best way to manage date/timezones in Swift | | Hydra | Write better async code: async/await & promises | | Flow | A new declarative approach to table managment. Forget datasource & delegates. | | SwiftRichString | Elegant & Painless NSAttributedString in Swift | | SwiftLocation | Efficient location manager | | SwiftMsgPack | Fast/efficient msgPack encoder/decoder |

How to get started

Documentation

Code is documented for Xcode, so you can use the built-in documentation panel to learn more about the library.

You can also generate the latest documentation using Jazzy; install Jazzy via gem install jazzy then, from terminal, move to the /SwiftDate folder and type jazzy -c jazzy.yaml. Documentation will be generated in docs folder.

Communication

Current Release

A complete list of changes for each release is available in the CHANGELOG file.

Help Us!

Currently we need translations for SwiftDate.bundle. Help us with a pull request!

Currently SwiftDate supports:

Make a pull request and add your language!

Installation

SwiftDate supports multiple methods for installing the library in a project.

Installation with CocoaPods

CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries like SwiftDate in your projects. You can install it with the following command:

$ gem install cocoapods

CocoaPods 1.0.1+ is required to build SwiftDate 4+ (along with Swift 3 and Xcode 8).

Podfile

To integrate SwiftDate into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'

target 'TargetName' do
  use_frameworks!
  pod 'SwiftDate', '~> <VERSION>'
end

Then, run the following command:

$ pod install

Installation with Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate SwiftDate into your Xcode project using Carthage, specify it in your Cartfile:

github "malcommac/SwiftDate" ~> <VERSION>

Run carthage to build the framework and drag the built SwiftDate.framework into your Xcode project.

Requirements

Current version is compatible with:

  • Swift 4 or later
  • iOS 8 or later
  • macOS 10.10 or later
  • watchOS 2.0 or later
  • tvOS 9.0 or later
  • ...and virtually any platform which is compatible with Swift 3 and implements the Swift Foundation Library

Are you searching for an old (unsupported) SwiftDate version? Check out:

  • Swift 4.x: >= 4.5.1 Download here.
  • Swift 3.x: Latest compatible version is 4.3.0 Download here
  • Swift 2.3: Latest compatible version is 3.0.9 on swift_23 branch
  • Swift 2.2: Latest compatible version is 3.0.8

Credits & License

SwiftDate is owned and maintained by Daniele Margutti along with main contributions of Jeroen Houtzager.

As open source creation any help is welcome!

The code of this library is licensed under MIT License; you can use it in commercial products without any limitation.

The only requirement is to add a line in your Credits/About section with the text below:

Date and Time Management is provided by SwiftDate - http://www.swift-date.com
Created by Daniele Margutti and licensed under MIT License.

Your App and SwiftDate

We are interested in making a list of all projects which use this library. Feel free to open an Issue on GitHub with the name and links of your project; we'll add it to this site.

Github

link
Stars: 3795
Help us keep the lights on

Dependencies

Releases

4.5.0 - Nov 26, 2017

CHANGELOG

  • #495 Added Thai language (thanks to Thanakrit Weekhamchai)
  • #492 Introduced a new ColloquialDateFormatter class
  • #503 Added isBetween to check if a date is inside a given dates range with passed granularity.
  • #505 Exposed reference date for in() function of TimeInterval. If specified conversion of the interval is aware of daylight saving time and calendar's specific dates; when not specified absolute conversion still available (only for .day,.hour,.minute,.second components).

4.4.2 - Oct 26, 2017

Release Date: 2017-11-26 Zipped Version: Download 4.4.2

  • #495 Added Persian language
  • #489 Disabled LLV Code Coverage scheme
  • #494 Removed String.characters warning from Swift 3.x
  • #487 Fixed a regression with rangeAt instead of range(at) from Swift 3.x)

4.4.1 - Sep 15, 2017

  • #483 Fixes a minor issue with NSRange under XCode 9

4.4.0 - Sep 14, 2017

  • Release Date: 2017-09-14

  • Zipped Version for Swift 4: Download 4.4.0

  • #480 Fix for '-' operator both in Date and DateInRegion classes where the result is correctly reported.

  • #476 Added Russian translation thanks to roor

4.3.0 - Sep 14, 2017

  • Release Date: 2017-09-14

  • Zipped Version for Swift 3: Download 4.3.0

  • #480 Fix for '-' operator both in Date and DateInRegion classes where the result is correctly reported.

  • #476 Added Russian translation thanks to roor