1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57
|
//===----------------------------------------------------------------------===//
//
// This source file is part of the Swift.org open source project
//
// Copyright (c) 2024 Apple Inc. and the Swift project authors
// Licensed under Apache License v2.0 with Runtime Library Exception
//
// See https://swift.org/LICENSE.txt for license information
// See https://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
//
//===----------------------------------------------------------------------===//
// MARK: Date Extensions
@available(macOS 12.0, iOS 15.0, tvOS 15.0, watchOS 8.0, *)
extension Date {
/// Converts `self` to its textual representation.
/// - Parameter format: The format for formatting `self`.
/// - Returns: A representation of `self` using the given `format`. The type of the representation is specified by `FormatStyle.FormatOutput`.
#if FOUNDATION_FRAMEWORK
public func formatted<F: Foundation.FormatStyle>(_ format: F) -> F.FormatOutput where F.FormatInput == Date {
format.format(self)
}
#else
public func formatted<F: FoundationEssentials.FormatStyle>(_ format: F) -> F.FormatOutput where F.FormatInput == Date {
format.format(self)
}
#endif // FOUNDATION_FRAMEWORK
// Parsing
/// Creates a new `Date` by parsing the given representation.
/// - Parameter value: A representation of a date. The type of the representation is specified by `ParseStrategy.ParseInput`.
/// - Parameters:
/// - value: A representation of a date. The type of the representation is specified by `ParseStrategy.ParseInput`.
/// - strategy: The parse strategy to parse `value` whose `ParseOutput` is `Date`.
#if FOUNDATION_FRAMEWORK
public init<T: Foundation.ParseStrategy>(_ value: T.ParseInput, strategy: T) throws where T.ParseOutput == Self {
self = try strategy.parse(value)
}
#else
public init<T: FoundationEssentials.ParseStrategy>(_ value: T.ParseInput, strategy: T) throws where T.ParseOutput == Self {
self = try strategy.parse(value)
}
#endif // FOUNDATION_FRAMEWORK
/// Creates a new `Date` by parsing the given string representation.
#if FOUNDATION_FRAMEWORK
@_disfavoredOverload
public init<T: Foundation.ParseStrategy, Value: StringProtocol>(_ value: Value, strategy: T) throws where T.ParseOutput == Self, T.ParseInput == String {
self = try strategy.parse(String(value))
}
#else
@_disfavoredOverload
public init<T: FoundationEssentials.ParseStrategy, Value: StringProtocol>(_ value: Value, strategy: T) throws where T.ParseOutput == Self, T.ParseInput == String {
self = try strategy.parse(String(value))
}
#endif // FOUNDATION_FRAMEWORK
}
|