如何将NSDate以JSON格式发送给API？

2024-11-09 18:55:59

向 API 发送 JSON 格式的 NSDate

在与 Web 服务交互时，经常需要在请求体中包含日期信息。直接发送 NSDate 对象会导致错误，因为 JSON 标准不支持 NSDate 类型。本文将探讨如何正确地将日期数据以 JSON 格式发送到服务器。

问题分析

上述代码片段尝试直接将 NSDate 对象嵌入到 JSON 字符串中，这会导致服务端无法解析。JSON 支持的数据类型有限，包括字符串、数字、布尔值、数组和对象，但不包括 NSDate。因此，需要将 NSDate 转换成 JSON 兼容的格式，通常是字符串。

解决方案：日期格式化

最常用的方法是将 NSDate 对象转换为符合特定格式的字符串。服务端通常会指定日期格式，例如 ISO 8601 格式 (yyyy-MM-dd'T'HH:mm:ssZ)。

操作步骤

创建 NSDateFormatter 对象。
设置日期格式字符串。
使用 stringFromDate: 方法将 NSDate 转换为字符串。
将转换后的字符串嵌入到 JSON 数据中。

代码示例

// 1. 创建 NSURL
NSURL *url = [NSURL URLWithString:apiString];

// 2. 创建 NSMutableRequest
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];

// 3. 获取当前日期
NSDate *currentDate = [NSDate date];

// 4. 创建 NSDateFormatter
NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];

// 5. 设置日期格式 (例如 ISO 8601)
[dateFormatter setDateFormat:@"yyyy-MM-dd'T'HH:mm:ssZ"];
[dateFormatter setLocale:[NSLocale localeWithLocaleIdentifier:@"en_US_POSIX"]]; // 设置固定Locale避免本地化差异

// 6. 将 NSDate 转换为字符串
NSString *dateString = [dateFormatter stringFromDate:currentDate];

// 7. 创建 JSON 数据
NSDictionary *jsonDictionary = @{@"requestDate": dateString};
NSError *error = nil;
NSData *jsonData = [NSJSONSerialization dataWithJSONObject:jsonDictionary options:0 error:&error];

if (error) {
    NSLog(@"JSON 序列化错误: %@", error);
    return; // 处理错误
}

[request setHTTPBody:jsonData];
[request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"]; // 设置 Content-Type


// 8. 发送请求
[NSURLConnection sendAsynchronousRequest:request queue:[NSOperationQueue mainQueue] completionHandler:^(NSURLResponse *response, NSData *data, NSError *connectionError) {
    if (data != nil) {
        // 处理返回数据
    } else {
        NSLog(@"连接错误: %@", connectionError.localizedDescription);
    }
}];

使用时间戳

另一种方法是使用时间戳（Unix epoch time），它表示自 1970 年 1 月 1 日 00:00:00 UTC 以来的秒数或毫秒数。时间戳是一个数字，可以直接在 JSON 中使用。

操作步骤：

获取 NSDate 对象的时间戳。
将时间戳嵌入到 JSON 数据中。

代码示例：

NSTimeInterval timestamp = [[NSDate date] timeIntervalSince1970];  // 获取秒级时间戳
NSNumber *timestampNumber = @(timestamp);

NSDictionary *jsonDictionary = @{@"requestDate": timestampNumber};

// ...后续步骤与日期格式化方法相同...