在Qualtrics问卷中精确计算用户停留时间（跨日处理）

在qualtrics问卷设计中，经常需要收集用户在特定活动中的开始时间和结束时间，并计算其持续时长。例如，记录用户的“入睡时间”和“起床时间”，然后计算“在床时间”。当开始时间和结束时间跨越午夜（即结束时间在次日）时，传统的简单时间相减方法将无法得出正确结果。本教程将提供两种在qualtrics问卷中实现这一计算的方法，并确保跨午夜情况的准确处理。

1. 准备工作：获取时间输入

假设您已经在Qualtrics问卷中设置了两个问题，用于收集开始时间和结束时间，并使用类似flatpickr的时间选择器，其输出格式为HH:mm A（例如，11:00 PM和8:00 AM）。这些时间值将通过Qualtrics的管道文本（Piped Text）功能获取。

例如，如果开始时间问题是QID4，结束时间问题是QID12，您可以使用以下管道文本获取其值：

• 开始时间：${q://QID4/ChoiceTextEntryValue}
• 结束时间：${q://QID12/ChoiceTextEntryValue}

2. 方法一：原生JavaScript实现

这种方法不依赖任何外部库，直接使用JavaScript的Date对象进行时间解析和计算。

实现原理

1. 获取时间字符串：从Qualtrics问题中获取用户输入的开始和结束时间字符串。
2. 创建Date对象：将时间字符串与一个固定的日期（例如1/1/2000）组合，创建两个Date对象。
3. 处理跨午夜情况：通过比较时间字符串或解析后的时间，判断结束时间是否早于开始时间（例如，8:00 AM早于11:00 PM），如果是，则将结束时间的日期加一天。
4. 计算时间差：计算两个Date对象之间的毫秒差，然后转换为分钟。
5. 存储结果：将计算出的分钟数存储为Qualtrics的嵌入式数据（Embedded Data）。

代码示例

将以下JavaScript代码放置在Qualtrics问卷块的JavaScript编辑器中，通常是在Qualtrics.SurveyEngine.addOnReady函数内部，以确保在页面加载并准备好后执行。

Qualtrics.SurveyEngine.addOnReady(function() {
    // 1. 获取用户输入的开始和结束时间字符串
    // 请根据您的实际QID替换QID4和QID12
    var timeToBed = "${q://QID4/ChoiceTextEntryValue}";    // 例如 "11:00 PM"
    var timeOutOfBed = "${q://QID12/ChoiceTextEntryValue}"; // 例如 "8:00 AM"

    // 2. 创建Date对象
    // 为了进行比较，我们为时间设置一个任意的基准日期 (例如 "1/1/2000")
    var timeToBedDate = new Date("1/1/2000 " + timeToBed);
    var timeOutOfBedDate = new Date("1/1/2000 " + timeOutOfBed);

    // 3. 处理跨午夜情况
    // 如果结束时间在开始时间之前（例如，起床时间是次日早上），则将结束日期加一天
    // 注意：这里的比较是基于Date对象的内部毫秒值，如果timeOutOfBedDate在timeToBedDate之前，
    // 则说明它在第二天
    if (timeOutOfBedDate.getTime() < timeToBedDate.getTime()) {
        timeOutOfBedDate.setDate(timeOutOfBedDate.getDate() + 1);
    }

    // 4. 计算时间差（分钟）
    // 两个Date对象相减得到毫秒差，然后除以1000（秒）再除以60（分钟）
    var timeInBedMinutes = (timeOutOfBedDate - timeToBedDate) / 1000 / 60;

    // 5. 存储结果为嵌入式数据
    // "timeInBed" 是您自定义的嵌入式数据字段名
    Qualtrics.SurveyEngine.setEmbeddedData("timeInBed", timeInBedMinutes);

    // 可选：在控制台输出结果进行调试
    // console.log("入睡时间:", timeToBed);
    // console.log("起床时间:", timeOutOfBed);
    // console.log("计算在床时间 (分钟):", timeInBedMinutes);
});

注意事项

• 日期格式：new Date("1/1/2000 " + timeString)这种构造方式对时间字符串的格式有一定要求。确保您的时间选择器输出的格式能被JavaScript Date对象正确解析。HH:mm A（如11:00 PM）通常可以。
• 时区问题：Date对象默认使用本地时区。如果在不同时区进行问卷填写或数据分析，可能会出现偏差。对于严格的时区要求，可能需要更复杂的处理。
• QID替换：务必将代码中的QID4和QID12替换为您问卷中实际的时间输入问题ID。

3. 方法二：使用Moment.js库优化

Moment.js是一个强大的JavaScript日期处理库，它提供了更简洁、更健壮的API来解析、操作和格式化日期时间。

实现原理

1. 引入Moment.js：在Qualtrics问卷中加载Moment.js库。
2. 创建Moment对象：使用moment()函数和指定的时间格式解析时间字符串，创建Moment对象。
3. 处理跨午夜情况：利用Moment对象的isBefore()方法判断结束时间是否早于开始时间，如果是，则使用add(1, 'day')将结束时间加一天。
4. 计算时间差：使用diff()方法直接计算两个Moment对象之间的分钟差。
5. 存储结果：将计算出的分钟数存储为Qualtrics的嵌入式数据。

引入Moment.js

在Qualtrics问卷的“外观与感觉”->“高级”->“页眉”或“页脚”部分，添加以下

注意：确保此脚本在您尝试使用Moment.js的代码之前加载。

代码示例

将以下JavaScript代码放置在Qualtrics问卷块的JavaScript编辑器中，通常是在Qualtrics.SurveyEngine.addOnReady函数内部。

Qualtrics.SurveyEngine.addOnReady(function() {
    // 确保Moment.js已加载
    if (typeof moment === 'undefined') {
        console.error("Moment.js library is not loaded. Please ensure the script tag is correctly placed.");
        return;
    }

    // 1. 获取用户输入的开始和结束时间字符串
    // 请根据您的实际QID替换QID4和QID12
    var timeToBedString = "${q://QID4/ChoiceTextEntryValue}";    // 例如 "11:15 PM"
    var timeOutOfBedString = "${q://QID12/ChoiceTextEntryValue}"; // 例如 "8:05 AM"

    // 2. 创建Moment对象，并指定输入时间字符串的格式
    // "HH:mm A" 是用于解析 "11:15 PM" 或 "8:05 AM" 这种格式
    var timeToBedMoment = moment(timeToBedString, "HH:mm A");
    var timeOutOfBedMoment = moment(timeOutOfBedString, "HH:mm A");

    // 3. 处理跨午夜情况
    // 如果起床时间在入睡时间之前，说明起床时间是第二天
    if (timeOutOfBedMoment.isBefore(timeToBedMoment)) {
        timeOutOfBedMoment.add(1, 'day'); // 将起床时间加一天
    }

    // 4. 计算时间差（分钟）
    // diff() 方法直接计算两个Moment对象之间的差异，单位为 'minutes'
    var timeInBedMinutes = timeOutOfBedMoment.diff(timeToBedMoment, 'minutes');

    // 5. 存储结果为嵌入式数据
    Qualtrics.SurveyEngine.setEmbeddedData("timeInBed", timeInBedMinutes);

    // 可选：在控制台输出结果进行调试
    // console.log("入睡Moment对象:", timeToBedMoment.format());
    // console.log("起床Moment对象:", timeOutOfBedMoment.format());
    // console.log("计算在床时间 (分钟):", timeInBedMinutes);
});

优势与注意事项

• 格式化解析：Moment.js能够通过指定格式字符串("HH:mm A")更精确地解析各种时间格式，减少因格式不匹配导致的错误。
• 语义化API：isBefore(), add(), diff()等方法使代码更易读、易懂。
• 时区处理：Moment.js提供了更高级的时区处理功能（如moment.tz），如果您的项目需要复杂的时区管理，Moment.js是更好的选择。
• 库的引入：务必在您的代码执行之前正确引入Moment.js库。
• QID替换：同样需要替换代码中的QID4和QID12。

4. 总结

在Qualtrics问卷中计算跨午夜的时间差是一个常见的需求。无论是选择原生JavaScript实现还是Moment.js库，核心都在于正确处理日期跨越午夜的逻辑。

• 原生JavaScript方法轻量，无需引入外部库，适用于对性能要求不高且时间格式相对固定的场景。但其日期解析和时区处理能力相对较弱。
• Moment.js方法则提供了更强大、更灵活的日期时间处理能力，代码更简洁、健壮，尤其适用于需要处理多种时间格式或复杂时区逻辑的场景。缺点是需要引入一个外部库，会略微增加页面加载负担。

根据您的项目需求和对代码复杂度的接受程度，选择最适合您的方法。通过将计算结果存储为嵌入式数据，您可以轻松地在Qualtrics的数据分析中利用这些计算出的时长。