Cocoa Foundation框架学习笔记 － NSCalendar

+ (void)beginTest
{
    /*
     FOUNDATION_EXPORT NSString * const NSGregorianCalendar;        //公历（经常使用）
     FOUNDATION_EXPORT NSString * const NSBuddhistCalendar;         //佛教日历
     FOUNDATION_EXPORT NSString * const NSChineseCalendar;          //中国农历（经常使用）
     FOUNDATION_EXPORT NSString * const NSHebrewCalendar;           //希伯来日历
     FOUNDATION_EXPORT NSString * const NSIslamicCalendar;          //伊斯兰历
     FOUNDATION_EXPORT NSString * const NSIslamicCivilCalendar;     //伊斯兰教日历
     FOUNDATION_EXPORT NSString * const NSJapaneseCalendar;         //日本日历(和历，经常使用)
     FOUNDATION_EXPORT NSString * const NSRepublicOfChinaCalendar;  //中华民国日历（台湾）
     FOUNDATION_EXPORT NSString * const NSPersianCalendar;          //波斯历
     FOUNDATION_EXPORT NSString * const NSIndianCalendar;           //印度日历
     FOUNDATION_EXPORT NSString * const NSISO8601Calendar;          //ISO8601（可是如今还不可用）
     */
    
    
    //-- System Locale Information
    
    //+ currentCalendar
    //取得当前用户的逻辑日历
    //currentCalendar取得的值会一直保持在cache中,第一次取得之后若是用户修改该系统日历设定，这个值也不会改变。
    NSCalendar *calendar = [NSCalendar currentCalendar];
    NSLog(@"calendar = %@",calendar);
    
    //+ (id)autoupdatingCurrentCalendar
    //取得当前用户的逻辑日历
    //用autoupdatingCurrentCalendar，那么每次取得的值都会是当前系统设置的日历的值。
    NSString *autoupdatingCurrent = [NSCalendar autoupdatingCurrentCalendar];
    NSLog(@"autoupdatingCurrent = %@",autoupdatingCurrent);
    
    //--
    
    //-- Initializing a Calendar
    
    //- initWithCalendarIdentifier:
    //若是想要用公历的时候，就要将NSDateFormatter的日历设置成公历。不然随着用户的系统设置的改变，取得的日期的格式也会不同。
    NSCalendar *initCalendar = [[[NSCalendar alloc]initWithCalendarIdentifier:NSGregorianCalendar] autorelease];
    NSDateFormatter *formatter = [[[NSDateFormatter alloc] init] autorelease];
    [formatter setCalendar:initCalendar];
    
    //- setFirstWeekday:
    //设置第一个工做日
    //设定每周的第一天从星期几开始，好比:
    //.  如需设定从星期日开始，则value传入1
    //.  如需设定从星期一开始，则value传入2
    //.  以此类推
    [initCalendar setFirstWeekday:1];
    
    //– setLocale:
    //设置设置区域
    [initCalendar setLocale:[[[NSLocale alloc] initWithLocaleIdentifier:@"en_US"] autorelease]];
    
    //设定做为(每一年及每个月)第一周必须包含的最少天数，好比:.  如需设定第一周最少包括7天，则value传入7
    //– setMinimumDaysInFirstWeek:
    [initCalendar setMinimumDaysInFirstWeek:7];
    
    //– setTimeZone:
    //设置时区
    [initCalendar setTimeZone:[NSTimeZone defaultTimeZone]];
    
    //--
    
    //-- Getting Information About a Calendar
    
    //– calendarIdentifier
    //返回日历标示符
    NSString *calendarIdentifier = [initCalendar calendarIdentifier];
    NSLog(@"calendarIdentifier = %@",calendarIdentifier);
    
    //– firstWeekday
    //返回日历指定的每周的第一天从星期几开始。缺省为星期天，即firstWeekday = 1
    int firstWeekday = [initCalendar firstWeekday];
    NSLog(@"firstWeekday = %d",firstWeekday);
    
    //– locale
    // 返回日历指定的地区信息。
    NSLocale *locale = [initCalendar locale];
    NSLog(@"locale = %@",locale.localeIdentifier);
    
    //– maximumRangeOfUnit:    //返回单元的最大范围
    //- minimumRangeOfUnit:    //返回单元的最小范围 //好比Day Calendar Unit就是一个月最多31天这个意思
    NSRange range = [initCalendar maximumRangeOfUnit:NSDayCalendarUnit];
    NSLog(@"range = %d",range.length);
    
    //- minimumDaysInFirstWeek
    //返回日历指定的第一周必须包含的最少天数。
    int minimumDays = [initCalendar minimumDaysInFirstWeek];
    NSLog(@"minimumDays = %d",minimumDays);
    
    //- ordinalityOfUnit:inUnit:forDate:
    //在一个给定的时间，小日历单元如（一天）在大日历单元（一周）中的序数。
    //好比forDate参数是星期一，并且firstWeekday 参数被设置为2（也就是星期一为一周的第一天）,那么返回为1
    //经过这个函数能够判断 例如 ：给定的日期是在一周的第几天，或一月的第几周。一年的第几个月。一年的第几天等
    //注:firstWeekday的设定会影响这个函数的返回值
    int ordinality = [initCalendar ordinalityOfUnit:NSWeekdayCalendarUnit inUnit:NSWeekCalendarUnit forDate:[NSDate date]];
    NSLog(@"ordinality = %d",ordinality);
    
    //- rangeOfUnit:inUnit:forDate:
    //一个小日历单元下。大日历单元的范围 例如 小日历单元是天。大日历单元是周。那么范围就是7天。就是1-7
    NSRange rangeOfUnit = [initCalendar rangeOfUnit:NSWeekdayCalendarUnit inUnit:NSWeekCalendarUnit forDate:[NSDate date]];
    NSLog(@"rangeOfUnit = %d",rangeOfUnit.length);
    
    //– rangeOfUnit:startDate:interval:forDate:
    //用于返回日期date(参数)所在的那个日历单元unit(参数)的开始时间(sDate)。
    //其中参数unit指定了日历单元，参数sDate用于返回日历单元的第一天，参数unitSecs用于返回日历单元的长度(以秒为单位)，参数date指定了一个特定的日期。
    //若是startDate和interval均为可计算的，那么函数返回YES不然返回NO.好比:
    NSDate *dateOut = [NSDate date];
    NSDate **sDate = &dateOut;
    
    NSDateComponents *dc = [[NSDateComponents alloc] init];
    [dc setYear: 2013];
    [dc setMonth: 4];
    [dc setDay: 6];
    
    NSDate *date = [calendar dateFromComponents:dc];
    [dc release];
    NSTimeInterval intOut;
    NSTimeInterval *intervalOut = &intOut;
    
    if ([initCalendar rangeOfUnit:NSWeekCalendarUnit startDate:sDate interval:intervalOut forDate:date]){
        NSLog(@"%@", [*sDate description]);
        NSLog(@"%f", *intervalOut/60/60/24);
    }
    else{
        NSLog(@"Can not be calculated!");
    }
    
    //- timeZone:
    //返回日历指定的时区信息。
    NSTimeZone *timeZone = [initCalendar timeZone];
    NSLog(@"timeZone = %@",timeZone.abbreviation);
    
    //--
    
    //-- Calendrical Calculations
    
    //- components:fromDate:
    //返回时间组件
    unsigned unitFlags = NSYearCalendarUnit | NSMonthCalendarUnit |  NSDayCalendarUnit;
    NSDateComponents *comps = [initCalendar components:unitFlags fromDate:[NSDate date]];
    NSLog(@"NSDateComponents - %d",comps.year);
    
    //- components:fromDate:toDate:options:
    //返回时间组件 比较2个日期
    NSDate *startDate = date;
    NSDate *endDate = [NSDate date];
    unsigned int unitFlags2 = NSMonthCalendarUnit | NSDayCalendarUnit;
    NSDateComponents *comps2 = [initCalendar components:unitFlags2 fromDate:startDate  toDate:endDate  options:0];
    int months = [comps2 month];
    int days = [comps2 day];
    NSLog(@"months = %d days = %d",months,days);
    
    //- dateByAddingComponents:toDate:options:
    //追加日期 并返回一个新日期
    //
    NSDate *currentDate = [NSDate date];
    NSDateComponents *comps3 = [[NSDateComponents alloc] init];
    [comps3 setMonth:2];
    [comps3 setDay:3];
    NSDate *newDate = [initCalendar dateByAddingComponents:comps3 toDate:currentDate  options:0];
    [comps3 release];
    NSLog(@"newDate = %@",newDate);
    
    //- dateFromComponents:
    //建立日期
    {
        NSCalendar *calendar = [NSCalendar currentCalendar];
        NSDateComponents *comps = [[NSDateComponents alloc] init];
        [comps setYear:1965];
        [comps setMonth:1];
        [comps setDay:1];
        [comps setHour:2];
        [comps setMinute:10];
        [comps setSecond:0];
        NSDate *date = [calendar dateFromComponents:comps];
        [comps release];
        NSLog(@"date = %@",date);
    }
}