Latest 1.1.0
Homepage https://github.com/azu/TimeRange
License MIT
Platforms ios 6.0, requires ARC
Authors

CI Status
Version
License
Platform
Dependency Status

TimeRange provide check if an NSDate occurs between two other NSDates.

  • Check if an NSDate is contained TimeRange.( e.g. 12:00 is contained 10:00 ~ 20:00 )
  • Check if an TimeRange overlaps the other TimeRange.

Installation

TimeRange is available through CocoaPods. To install
it, simply add the following line to your Podfile:

pod "TimeRange"

Usage

You can try to:

pod try "TimeRange"

img

API

@interface TimeRange : NSObject
// CAUTION : You should not access directory these property.
@property(nonatomic, readonly) NSDate *aDate;
@property(nonatomic, readonly) NSDate *bDate;

+ (instancetype)rangeWithStartDate:(NSDate *) startDate endDate:(NSDate *) endDate;

- (BOOL)contains:(NSDate *) targetData;

- (BOOL)overlaps:(TimeRange *) anotherTimeRange;

- (NSString *)description;
@end

contains

Check if an NSDate is contained TimeRange

/*
    20:00 ~ 04:00

    target date is 01:00

    It's contained the time range.
*/
NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
[formatter setCalendar:[[NSCalendar alloc] initWithCalendarIdentifier:NSGregorianCalendar]];
[formatter setDateFormat:@"HH:mm:ss"];
NSDate *aDate = [formatter dateFromString:@"20:00"];
NSDate *bDate = [formatter dateFromString:@"04:00"];
TimeRange *timeRange = [TimeRange rangeWithStartDate:aDate bDate:bDate];
NSDate *targetDate = [formatter dateFromString:@"01:00"];
[timeRange contains:targetDate];// => YES

overlaps

Compare TimeRanges.

/*
    04:00 ~ 10:00
    17:00 ~ 23:00

    are doesn't overlap.
*/

NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
[formatter setCalendar:[[NSCalendar alloc] initWithCalendarIdentifier:NSGregorianCalendar]];
[formatter setDateFormat:@"HH:mm:ss"];
NSArray *aRangeData = @[@"04:00:00", @"10:00:00"];
NSArray *bRangeData = @[@"17:00:00", @"23:00:00"];
TimeRange *aRange = [TimeRange rangeWithStartDate:[formatter dateFromString:aRangeData[0]] bDate:[formatter dateFromString:aRangeData[1]]];
TimeRange *bRange = [TimeRange rangeWithStartDate:[formatter dateFromString:bRangeData[0]] bDate:[formatter dateFromString:bRangeData[1]]];
[aRange overlaps:bRange];// => NO

overlap

Contributing

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D

License

MIT

Acknowledgment

Latest podspec

{
    "name": "TimeRange",
    "version": "1.1.0",
    "summary": "TimeRange provide check if an NSDate occurs between two other NSDates.",
    "homepage": "https://github.com/azu/TimeRange",
    "screenshots": "http://monosnap.com/image/9NniA7H5i5cnpBnCnC0YU77aPnjbVY.png",
    "license": "MIT",
    "authors": {
        "azu": "[email protected]"
    },
    "source": {
        "git": "https://github.com/azu/TimeRange.git",
        "tag": "1.1.0"
    },
    "social_media_url": "https://twitter.com/azu_re",
    "platforms": {
        "ios": "6.0"
    },
    "requires_arc": true,
    "source_files": "Pod/Classes"
}

Pin It on Pinterest

Share This