在检索选定日期范围内的数据时，我们注意到我们的计算存在一定偏差。然而，当我们将日期减少一天时，数据完全匹配！

嗯……我们的代码中处理日期的方式可能存在问题。也许时区处理不正确——是的，我是对的！

当构建涉及来自不同时区的用户的应用程序时，正确处理日期可能很棘手。在 UTC 中存储日期是确保一致性的常见最佳实践，但当用户在本地时区输入日期时，尤其是在过滤和查询期间，事情可能会变得复杂。

开发人员经常求助于本机JavaScript Date 对象来处理这些转换。然而，这种方法可能会导致跨环境的不一致，例如 Node.js 与 Chrome 等浏览器控制台。在本文中，我们将探讨为什么正确处理日期和时区转换至关重要，Luxon 如何使此过程变得更容易，以及为什么依赖本机 JavaScript Date 对象会导致不一致。

问题：UTC 存储与本地时间过滤

当日期以 UTC 格式存储时，它们代表了消除时区引起的歧义的全球标准。然而，用户通常会根据他们的本地时区进行思考。当用户尝试使用本地时间输入按日期过滤记录时，这种差异变得明显。

让我们看一个示例，如果处理不当，用户的当地时间输入可能会导致丢失记录。

示例场景：GMT-7 时区的用户

想象一下 GMT-7 时区（太平洋夏令时间）的用户。 2024 年 9 月 5 日，他们在当地时间 10:00 PM 创建了一条记录。以下是幕后发生的事情：

• 2024 年 9 月 5 日，晚上 10:00 GMT-7 转换为 2024 年 9 月 6 日，05:00 AM UTC 并按原样存储在数据库中。
• 但是，用户认为他们是在 9 月 5 日创建了此记录。

过滤器不匹配

现在，假设用户想要查询9月5日创建的所有记录。他们输入日期2024年9月5日，希望检索到他们的记录。但是，如果系统直接将输入日期与存储的UTC日期进行比较，而不调整时区差异，则用户将错过该记录。为什么？

• 该记录在数据库中保存为9月6日 (UTC)。
• 用户过滤了9 月 5 日（他们的当地时间），但系统将此与 UTC 进行比较，导致不匹配。

JavaScript 日期对象：跨环境的不一致

以下示例代码演示了使用本机 JavaScript Date 对象处理日期和时间转换时的常见问题，特别是在 Node.js 和浏览器（例如 Chrome 控制台）等不同环境中。

示例代码：

function convertToUtcStartOfDay(isoString) {
  // Step 1: Parse the ISO string into a Date object
  let localDate = new Date(isoString);

  // Step 2: Set the time to the start of the day (00:00:00) in local time zone
  localDate.setHours(0, 0, 0, 0);

  // Step 3: Get the UTC time using toISOString() – it converts local time to UTC
  let utcStartOfDay = localDate.toISOString();

  return utcStartOfDay; // This will be in UTC
}

// Example usage:
let frontendDate = "2023-08-22T00:00:00 05:30"; // ISO string with timezone offset
let startOfDayUtc = convertToUtcStartOfDay(frontendDate);

console.log(startOfDayUtc); // Expected output: "2023-08-21T18:30:00.000Z"

在此示例中，用户输入日期“2023-08-22T00:00:00 05:30”（来自 GMT 5:30 时区）。 Date 对象应将其转换为 UTC 中一天的开始时间，但执行时：

• 在 Node.js 中，输出为 2023-08-21T00:00:00.000Z - 错误
• 在Chrome的控制台中，输出为2023-08-21T18:30:00.000Z - 正确

这种差异可能会导致不可预测的结果，具体取决于代码的执行位置。此行为使得 Date 对象无法可靠地在不同环境中进行一致的日期处理。

使用 Luxon 进行准确的日期处理

要解决这个问题，使用像 Luxon 这样的库非常重要，它可以在不同环境中提供一致的行为。 Luxon 帮助您将用户的本地输入转换为所在时区当天正确的开始和结束，然后将这些时间转换为 UTC 以进行准确的数据库查询。

这是使用 Luxon 处理此问题的示例：

const { DateTime } = require('luxon');

// Example user input date in ISO string with timezone information from the frontend
const userInputDate = "2023-08-22T00:00:00 05:30"; // ISO string sent by frontend

// Step 1: Parse the ISO string to get the user's local time
const userLocalDate = DateTime.fromISO(userInputDate);

// Step 2: Convert this date to start of the day and end of the day in the user's local timezone
const startOfDayLocal = userLocalDate.startOf('day'); // start of the day in the user's timezone
const endOfDayLocal = userLocalDate.endOf('day'); // end of the day in the user's timezone

// Step 3: Convert these local start and end times to UTC
const startOfDayUtc = startOfDayLocal.toUTC().toJSDate(); // start of the day in UTC
const endOfDayUtc = endOfDayLocal.toUTC().toJSDate(); // end of the day in UTC

// Step 4: Query the database using the UTC range
db.records.find({
  createdAt: {
    $gte: startOfDayUtc,
    $lte: endOfDayUtc
  }
});

为什么 Luxon 比 JavaScript 日期对象更好

直接使用原生 JavaScript Date 对象处理日期和时区转换可能会导致像上面演示的那样的不一致。以下是 Luxon 是更好选择的几个原因：

1. 跨环境的一致性：无论代码是在 Node.js 还是浏览器（例如 Chrome 控制台）中运行，Luxon 都提供一致的行为。这消除了在不同环境中使用 Date 对象所产生的差异。

2. 内置时区支持：Luxon 可以轻松地在时区之间进行转换，而 Date 对象不提供对时区操作的强大支持。

3. 简单日期操作：设置用户本地时区的一天的开始或结束并将其转换为 UTC 是全球应用程序中的常见任务。 Luxon 通过其直观的 API 简化了此过程，而 Date 则需要复杂的手动处理。

结论

正确处理日期和时区转换对于构建可靠、用户友好的应用程序至关重要。如果开发人员在过滤记录时未能考虑到时区差异，用户可能会错过重要数据，从而导致混乱和潜在的严重错误。

使用 Luxon 而不是原生 JavaScript Date 对象 可提供一致性、更好的时区处理和更轻松的日期操作。这使得开发人员能够为跨时区的用户创建无缝体验，确保查询按预期工作，并且在过滤过程中不会遗漏任何记录。

在全球应用程序中，准确可靠的日期处理是为用户提供高质量体验的关键，无论用户位于哪个时区。

最后的想法

您是否遇到过类似的情况，即日期和时区处理导致您的应用程序出现意外结果？你是如何解决这个问题的？我很想听听您的经历、反馈或您可能有的任何问题或疑虑。欢迎在下面的评论部分分享它们。如果您觉得本文有帮助，请点赞并分享给可能从中受益的其他人！