首页 > web前端 > js教程 > 正文

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

DDD
发布: 2025-09-29 14:29:39
原创
522人浏览过

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

本教程详细介绍了如何在Qualtrics问卷中计算用户输入的开始时间和结束时间之间的分钟差,尤其关注跨午夜(即跨日)情况的处理。文章提供了两种实现方法:纯JavaScript原生实现和利用Moment.js库的优化方案,并附有详细代码示例和注意事项,帮助开发者准确获取用户在特定活动中的持续时间,并将结果存储为嵌入式数据。

在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问卷的“外观与感觉”->“高级”->“页眉”或“页脚”部分,添加以下<script>标签以引入Moment.js库:

采风问卷
采风问卷

采风问卷是一款全新体验的调查问卷、表单、投票、评测的调研平台,新奇的交互形式,漂亮的作品,让客户眼前一亮,让创作者获得更多的回复。

采风问卷 20
查看详情 采风问卷
<script src="https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.29.4/moment.min.js"></script>
登录后复制

注意:确保此脚本在您尝试使用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的数据分析中利用这些计算出的时长。

以上就是在Qualtrics问卷中精确计算用户停留时间(跨日处理)的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
热门推荐
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号