AnyDate alternatives and similar libraries
Based on the "Date" category.
Alternatively, view AnyDate alternatives based on common mentions on social networks and blogs.
-
SwiftDate
๐ Toolkit to parse, validate, manipulate, compare and display dates, time & timezones in Swift. -
TrueTime.swift
NTP library for Swift and Objective-C. Get the true time impervious to device clock changes. -
TypedDate
Library for enhancing Swift's Date handling by enabling type-level customization of date components
CodeRabbit: AI Code Reviews for Developers
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of AnyDate or a related project?
README
AnyDate
Swifty Date & Time API inspired from Java 8 DateTime API.
Background
I think that date & time API should be easy and accurate.
Previous dates, times, timezones API of Swift are inconvenience to use. (It's very complex to create, manipulate or everything else.)
But there's quite nice pioneer, The Brand New Time API of Java8.
Java 8 introduced whole new API for handle date & time more efficiently and easy a.k.a LocalDateTime, ZonedDateTime(JSR-310). The main idea that is:
- Immutable-value classes
- Domain-driven design
- Separation of chronologies
Those ideas can be easily ported to another languages, like .Net's Rx ports of another languages.
So, here's the AnyDate, whole new Swift date & time API that has coherence between Java 8.
Features
- [x] Convinience typed year, month, day, time.
- [x] Pre-defined Timezone Identifiers.
- [x] Null-Safe types.
- [x] Separation of chronologies.
- [x] Coherence with Java.
- [x] Operators supported.
- [x] Easy to manipulate.
FAQ
- Looks like SwiftDate?
- SwiftDate is a support library for Date, AnyDate can completely replace Date.
Usage
- Convinience typed year, month, day, time.
/// Before
let now1 = Date()
var calendar = Calendar.current
calendar.timeZone = TimeZone(identifier: "UTC")!
let day = calendar.components(.day, from: now1)
/// After
let now2 = ZonedDateTime(Clock.utc)
let day = now2.day
- Pre-defined Timezone Identifiers. String typed timezones are not safe from your TYPING ERROR. (Plz, do not belive your finger. They can always betray you.)
/// Before
let timeZone1 = TimeZone(identifier: "GMT+0900")!
let timeZone2 = TimeZone(identifier: "America/Argentina/Buenos_Aires")!
/// After
let clock1 = Clock(offsetHour: 9)
let clock2 = Clock(identifier: .americaArgentinaBuenosAires)
- Null-Safe types. NO MORE NEEDLESS GUARD & OPTIONAL AND INDENT INCRESEMENT :-D
/// Before
var dateComponents = DateComponents()
dateComponents.year = 2000
dateComponents.month = 11
dateComponents.day = 30
dateComponents.hour = 11
dateComponents.minute = 51
dateComponents.second = 18
dateComponents.nanosecond = 1573
guard let date = Calendar.current.date(from: dateComponents) else {
assertionFailure("Failed to create!")
return
}
/// After
let date = LocalDateTime(
year: 2000,
month: 11,
day: 30,
hour: 11,
minute: 51,
second: 18,
nanoOfSecond: 1573
)
- Operators supported. Easy to compare dates, datetimes, times.
let min = ZonedDateTime.min
let max = ZonedDateTime.max
let oldDate = ZonedDateTime(year: 1627, month: 2, day: 10, hour: 14, minute: 2, second: 18, nanoOfSecond: 1573, clock: .UTC)
let newDate = ZonedDateTime(year: 1627, month: 2, day: 10, hour: 14, minute: 2, second: 18, nanoOfSecond: 1574, clock: .UTC)
let equalDate = ZonedDateTime(year: 1627, month: 2, day: 10, hour: 14, minute: 2, second: 18, nanoOfSecond: 1573, clock: .UTC)
let isLessThan = min < oldDate
let isGreaterThan = max > newDate
let isLessThanOrEqual = oldDate <= equalDate
let isGreaterThanOrEqual = oldDate >= equalDate
let isEqual = oldDate == equalDate
let isLessThan = oldDate < newDate
- Easy to manipulate. You can use our overridden operators to create / add / sub dates and times.
/// 1000-01-07T11:51:18.000001573
let date = LocalDateTime(
year: 1000,
month: 1,
day: 7,
hour: 11,
minute: 51,
second: 18,
nanoOfSecond: 1573
)
print(date)
/// Period(year: 1, month: 1, day: 9, hour: 2, minute: 3, second: 4, nano: 152)
let period = 1.year + 1.month + 1.week + 2.day + 2.hour + 3.minute + 4.second + 152.nanosecond
/// 1001-03-16T13:54:22.000001725
let newDate = date + period
print(newDate)
Installation
CocoaPods:
pod 'AnyDate', '~> 1.2.0'
Carthage:
github "kawoou/AnyDate" ~> 1.2.0
Swift Package Manager:
import PackageDescription
let package = Package(
name: "MyAwesomeApp",
dependencies: [
.Package(url: "https://github.com/kawoou/AnyDate", majorVersion: 1),
]
)
Manually
You can either simply drag and drop the Sources
folder into your existing project.
Requirements
- Swift 3.1
- iOS 8.0+
- tvOS 9.0+
- macOS 10.10+
- watchOS 2.0+
- Virtually any platform which is compatible with Swift 3 and implements the Swift Foundation Library.
Changelog
- 1.0.0 - 2017/08/13
- First release AnyDate!
- 1.0.1 - 2017/08/16
- Increase test codes.
- Implement CustomPlaygroundQuickLookable, CustomReflectable protocols.
- 1.0.2 - 2017/08/26
- Increase test codes.
- Support Codable protocol in swift 4.
- Add operators on Instant.
- 1.0.3 - 2017/09/03
- Hotfix, Comparable bugs.
- 1.0.4 - 2017/10/07
- Fix
Calendar(identifier: .iso8601)
crash on swift SR-3828.
- Fix
- 1.0.5 - 2018/04/11
- Support for Swift 4.1 and Xcode 9.3.
- 1.0.6 - 2018/05/20
- Support Hashable.
- 1.1.0 - 2018/10/18
- Support for Swift 4.2.
- 1.2.0 - 2019/04/04
- Support for Swift 5.0.
Author
- kawoou, [email protected]
- dave, [email protected]
Special Thanks
- Naming by ์๋ฉ๋ฐ
License
AnyDate is under MIT license. See the LICENSE file for more info.
*Note that all licence references and agreements mentioned in the AnyDate README section above
are relevant to that project's source code only.