バイナリー(準備されたステートメント)プロトコールはあなたに、日付値とタイム値(DATE、TIME、DATETIMEおよびTIMESTAMP)を、MYSQL_TIME構造を使って、送り且つ受け取ることを許します。この構造のメンバーは項23.2.5. 「準備されたC APIステートメントデータタイプ」で記述されます。

時間のデータ値を送るため、mysql_stmt_prepare()を使って準備されたステートメントを生成してください。その後、mysql_stmt_execute()を呼び出して、ステートメントを実行する前に、以下の手順を実行して各時間パラメータをセットしてください。

mysql_stmt_bind_param()を使ってパラメータデータをステートメントに固定(バインド)してください。こうすると、mysql_stmt_execute()を呼び出すことが可能になります。

時間値を復元する手順は、buffer_typeメンバーを受け取りを期待する値のタイプにセットし更に、bufferメンバーを戻り値を置くべきMYSQL_TIME構造のアドレスにセットする以外、同じです。mysql_stmt_execute()を呼び出した後、結果をフェッチする前に、バッファーをステートメントに固定(バインド)するmysql_bind_results()を使ってください。

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