MySQL 9.0 C API 开发者指南  /  ...  /  预处理语句处理日期和时间值

3.6.4 预处理语句处理日期和时间值

二进制(预处理语句)协议允许您使用 MYSQL_TIME 结构发送和接收日期和时间值(DATETIMEDATETIMETIMESTAMP)。此结构的成员在 第 6.2 节“C API 预处理语句数据结构” 中进行了描述。

要发送时间数据值,请使用 mysql_stmt_prepare() 创建预处理语句。然后,在调用 mysql_stmt_execute() 执行语句之前,请使用以下过程设置每个时间参数

  1. 在与数据值关联的 MYSQL_BIND 结构中,将 buffer_type 成员设置为指示您要发送的时间值类型的类型。对于 DATETIMEDATETIMETIMESTAMP 值,将 buffer_type 分别设置为 MYSQL_TYPE_DATEMYSQL_TYPE_TIMEMYSQL_TYPE_DATETIMEMYSQL_TYPE_TIMESTAMP

  2. MYSQL_BIND 结构的 buffer 成员设置为您传递时间值的 MYSQL_TIME 结构的地址。

  3. 填写 MYSQL_TIME 结构的成员,这些成员适用于要传递的时间值类型。

使用 mysql_stmt_bind_param()mysql_stmt_bind_named_param() 将参数数据绑定到语句。然后,您可以调用 mysql_stmt_execute()

要检索时间值,过程类似,只是您将 buffer_type 成员设置为您希望接收的值的类型,并将 buffer 成员设置为应放置返回值的 MYSQL_TIME 结构的地址。在调用 mysql_stmt_execute() 并获取结果之前,请使用 mysql_stmt_bind_result() 将缓冲区绑定到语句。

这是一个简单的示例,它插入 DATETIMETIMESTAMP 数据。假设 mysql 变量是一个有效的连接处理程序。

Press CTRL+C to copy
MYSQL_TIME ts; MYSQL_BIND bind[3]; MYSQL_STMT *stmt; strmov(query, "INSERT INTO test_table(date_field, time_field, \ timestamp_field) VALUES(?,?,?"); stmt = mysql_stmt_init(mysql); if (!stmt) { fprintf(stderr, " mysql_stmt_init(), out of memory\n"); exit(0); } if (mysql_stmt_prepare(mysql, query, strlen(query))) { fprintf(stderr, "\n mysql_stmt_prepare(), INSERT failed"); fprintf(stderr, "\n %s", mysql_stmt_error(stmt)); exit(0); } /* set up input buffers for all 3 parameters */ bind[0].buffer_type= MYSQL_TYPE_DATE; bind[0].buffer= (char *)&ts; bind[0].is_null= 0; bind[0].length= 0; ... bind[1]= bind[2]= bind[0]; ... mysql_stmt_bind_named_param(stmt, bind, 3, NULL); /* supply the data to be sent in the ts structure */ ts.year= 2002; ts.month= 02; ts.day= 03; ts.hour= 10; ts.minute= 45; ts.second= 20; mysql_stmt_execute(stmt); ..