MySQL 8.4 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 变量是一个有效的连接句柄。

  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);
  ..