27.7.16 C API 准备的日期和时间值的语句处理

二进制(准备好的语句)协议使您可以使用MYSQL_TIME结构发送和接收日期和时间值(DATE，TIME，DATETIME和TIMESTAMP)。 第 27.7.8 节“ C API 准备的语句数据结构”中描述了此结构的成员。

要发送时间数据值，请使用mysql_stmt_prepare()创建准备好的语句。然后，在调用mysql_stmt_execute()执行该语句之前，使用以下过程来设置每个时间参数：

• 在与数据值关联的MYSQL_BIND结构中，将buffer_type成员设置为指示您要发送哪种时间值的类型。对于DATE，TIME，DATETIME或TIMESTAMP值，分别将buffer_type设置为MYSQL_TYPE_DATE，MYSQL_TYPE_TIME，MYSQL_TYPE_DATETIME或MYSQL_TYPE_TIMESTAMP。

• 将MYSQL_BIND结构的buffer成员设置为您在其中传递时间值的MYSQL_TIME结构的地址。

• 填写适用于要传递的时间值类型的MYSQL_TIME结构的成员。

使用mysql_stmt_bind_param()将参数数据绑定到语句。然后，您可以致电mysql_stmt_execute()。

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

这是一个插入DATE，TIME和TIMESTAMP数据的简单示例。 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_param(stmt, bind);

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