如何通过jQuery/Ajax调用Django项目中自定义的Python时间偏移量计算函数

前端Ajax代码运行在用户浏览器端，Python函数运行在Django服务端，两者无法直接调用，需要先将偏移量计算函数封装为服务端接口，再通过Ajax请求接口获取计算结果。

1. 封装计算函数为Django视图 #

首先在对应App的views.py中编写接口，接收前端传递的计算所需参数（如当地时间、用户经纬度等），调用你已实现的偏移量计算逻辑后返回JSON结果：

from django.http import JsonResponse
from django.views.decorators.http import require_POST
from django.views.decorators.csrf import csrf_exempt
from .utils import calculate_time_offset # 替换为你自己编写的偏移量计算函数

# 生产环境建议移除@csrf_exempt装饰器，前端请求携带CSRF Token完成校验
@csrf_exempt
@require_POST
def get_time_offset(request):
    # 按你的计算逻辑所需提取请求参数
    local_datetime = request.POST.get("local_datetime")
    user_longitude = request.POST.get("longitude")
    user_latitude = request.POST.get("latitude")
    
    # 调用你已实现的计算函数
    offset_seconds = calculate_time_offset(local_datetime, user_longitude, user_latitude)
    
    return JsonResponse({
        "status": "success",
        "offset_seconds": offset_seconds
    })

2. 配置接口路由 #

在对应App的urls.py中新增接口路由规则：

from django.urls import path
from . import views

urlpatterns = [
    # 原有其他路由
    path("api/calculate-time-offset/", views.get_time_offset, name="calculate_time_offset"),
]

3. 前端Ajax调用接口 #

给你的触发按钮绑定点击事件，收集计算所需参数后发起请求，拿到偏移量后计算对应UTC时间即可用于后续的DateTime字段存储逻辑：

// 绑定按钮点击事件，替换为你的按钮ID
document.querySelector("#time-calculate-btn").addEventListener("click", function() {
    // 收集计算所需参数，示例参数请替换为你的实际业务取值逻辑
    const localDatetime = document.querySelector("#local-time-input").value;
    const userLng = 116.403874; // 可通过前端定位或用户预设信息获取
    const userLat = 39.914885;

    // 发起Ajax请求，以下为原生JS写法，也可替换为jQuery/axios等你熟悉的请求库
    const xhr = new XMLHttpRequest();
    xhr.open("POST", "/api/calculate-time-offset/");
    xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
    // 生产环境请携带CSRF Token，删除上一步的@csrf_exempt装饰器
    // xhr.setRequestHeader("X-CSRFToken", "你的CSRF Token值");
    
    xhr.onload = function() {
        if (xhr.status === 200) {
            const res = JSON.parse(xhr.responseText);
            const offsetSeconds = res.offset_seconds;
            // 计算UTC时间
            const localTs = new Date(localDatetime).getTime();
            const utcTs = localTs + offsetSeconds * 1000;
            const finalUtcTime = new Date(utcTs).toISOString();
            // 后续可将finalUtcTime提交到对应存储接口，写入DateTime字段
            console.log("计算得到的UTC时间：", finalUtcTime);
        } else {
            console.error("请求失败，状态码：", xhr.status);
        }
    };
    
    // 发送请求参数
    xhr.send(`local_datetime=${encodeURIComponent(localDatetime)}&longitude=${userLng}&latitude=${userLat}`);
});

注意事项 #

• 所有涉及时区、真太阳时、夏令时的计算逻辑全部放在后端Python函数中处理，前端仅做参数传递和结果使用，避免两端计算逻辑不一致导致的时间误差
• 存储DateTime字段时确保字段未设置auto_now_add=True或auto_now=True，允许手动传入计算好的UTC时间
• 真太阳时计算依赖经纬度精度，建议优先通过前端定位获取用户实际经纬度，若使用预设值需提前做好精度校验

内容的提问来源于stack exchange，提问作者Matteo Nicoli