61 lines
2.1 KiB
C
61 lines
2.1 KiB
C
|
/* Copyright (c) 2011 Google Inc.
|
||
|
|
*
|
||
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||
|
|
* you may not use this file except in compliance with the License.
|
||
|
|
* You may obtain a copy of the License at
|
||
|
|
*
|
||
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
*
|
||
|
|
* Unless required by applicable law or agreed to in writing, software
|
||
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
|
|
* See the License for the specific language governing permissions and
|
||
|
|
* limitations under the License.
|
||
|
|
*/
|
||
|
|
|
||
|
|
//
|
||
|
|
// GTLDateTime.h
|
||
|
|
//
|
||
|
|
// This is an immutable class representing a date and optionally a
|
||
|
|
// time with time zone.
|
||
|
|
//
|
||
|
|
|
||
|
|
#import <Foundation/Foundation.h>
|
||
|
|
#import "GTLDefines.h"
|
||
|
|
|
||
|
|
@interface GTLDateTime : NSObject <NSCopying> {
|
||
|
|
NSDateComponents *dateComponents_;
|
||
|
|
NSInteger milliseconds_; // This is only for the fraction of a second 0-999
|
||
|
|
NSInteger offsetSeconds_; // may be NSUndefinedDateComponent
|
||
|
|
BOOL isUniversalTime_; // preserves "Z"
|
||
|
|
NSTimeZone *timeZone_; // specific time zone by name, if known
|
||
|
|
}
|
||
|
|
|
||
|
|
+ (GTLDateTime *)dateTimeWithRFC3339String:(NSString *)str;
|
||
|
|
|
||
|
|
// timeZone may be nil if the time zone is not known.
|
||
|
|
+ (GTLDateTime *)dateTimeWithDate:(NSDate *)date timeZone:(NSTimeZone *)tz;
|
||
|
|
|
||
|
|
// Use this method to make a dateTime for an all-day event (date only, so
|
||
|
|
// hasTime is NO.)
|
||
|
|
+ (GTLDateTime *)dateTimeForAllDayWithDate:(NSDate *)date;
|
||
|
|
|
||
|
|
+ (GTLDateTime *)dateTimeWithDateComponents:(NSDateComponents *)date;
|
||
|
|
|
||
|
|
@property (nonatomic, readonly) NSDate *date;
|
||
|
|
@property (nonatomic, readonly) NSCalendar *calendar;
|
||
|
|
|
||
|
|
@property (nonatomic, readonly) NSString *RFC3339String;
|
||
|
|
@property (nonatomic, readonly) NSString *stringValue; // same as RFC3339String
|
||
|
|
|
||
|
|
@property (nonatomic, readonly, retain) NSTimeZone *timeZone;
|
||
|
|
@property (nonatomic, readonly, copy) NSDateComponents *dateComponents;
|
||
|
|
@property (nonatomic, readonly) NSInteger milliseconds; // This is only for the fraction of a second 0-999
|
||
|
|
|
||
|
|
@property (nonatomic, readonly) BOOL hasTime;
|
||
|
|
@property (nonatomic, readonly) NSInteger offsetSeconds;
|
||
|
|
@property (nonatomic, readonly, getter=isUniversalTime) BOOL universalTime;
|
||
|
|
|
||
|
|
|
||
|
|
@end
|