Formatter Reference¶

This is the reference documentation for all the NSFormatters that Hydrant implements as conveniences for you. When using mappers that utilize formatters:

HYDMapObjectToStringByFormatter

HYDMapDateToString

HYDMapNumberToString

HYDMapUUIDToString

HYDMapURLToString

HYDMapStringToObjectByFormatter

HYDMapStringToDate

HYDMapStringToNumber

HYDMapStringToUUID

HYDMapStringToURL

They are also publicly exposed if you need or prefer to use these classes for other purposes.

Date Format Strings¶

Hydrant also includes a variety of constants that map to common datetime formats that you can use for NSDateFormatter:

NSString *HYDDateFormatRFC3339 = @"yyyy'-'MM'-'dd'T'HH':'mm':'ssZ";
NSString *HYDDateFormatRFC3339_milliseconds = @"yyyy'-'MM'-'dd'T'HH':'mm':'ss.SSSZ";

NSString *HYDDateFormatRFC822_day_seconds_gmt = @"EEE, d MMM yyyy HH:mm:ss zzz";
NSString *HYDDateFormatRFC822_day_gmt = @"EEE, d MMM yyyy HH:mm zzz";
NSString *HYDDateFormatRFC822_day_seconds = @"EEE, d MMM yyyy HH:mm:ss";
NSString *HYDDateFormatRFC822_day = @"EEE, d MMM yyyy HH:mm";
NSString *HYDDateFormatRFC822_seconds_gmt = @"d MMM yyyy HH:mm:ss zzz";
NSString *HYDDateFormatRFC822_gmt = @"d MMM yyyy HH:mm zzz";
NSString *HYDDateFormatRFC822_seconds = @"d MMM yyyy HH:mm:ss";
NSString *HYDDateFormatRFC822 = @"d MMM yyyy HH:mm";

HYDDotNetDateFormatter¶

This is an NSDateFormatter subclass that supports parsing of microsoft AJAX date formats which look like @"/Date(123456)/".

Since formatter sets some internal state from NSDateFormatter, so changing this formatter via properties may break its intended behavior.

HYDURLFormatter¶

This formatter utilizes NSURL to generate URLs and adds some extra safety by checking inputs before trying to construct an NSURL.

It can optionally be constructed with a set of schemes to allow.

HYDUUIDFormatter¶

This formatter utilizes NSUUID to generate UUIDs and adds some extra safety by checking inputs before trying to construct an NSUUID.