Reference documentation and code samples for the Cloud Spanner Client class CommitTimestamp.
A special value which, when used, will set the field value to the value of
the commit timestamp.
Cloud Spanner allows users to designate a specific Timestamp column in the
table schema to contain commit timestamps. When writing to this column, a
manually-created timestamp (in the past) may be supplied, or Cloud Spanner
can populate it server-side.
Note that this special value cannot be used unless the column has been
annotated with support for commit timestamps:
CREATE TABLE myTable (
id STRING(100) NOT NULL,
commitTimestamp TIMESTAMP NOT NULL OPTIONS
(allow_commit_timestamp=true)
) PRIMARY KEY(id, commitTimestamp DESC)
Example:
use Google\Cloud\Spanner\SpannerClient;
$spanner = new SpannerClient();
$database = $spanner->connect('my-instance', 'my-database');
$database->insert('myTable', [
'id' => $id,
'commitTimestamp' => $spanner->commitTimestamp()
]);
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Cloud Spanner Client - Class CommitTimestamp (1.104.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.104.0 (latest)](/php/docs/reference/cloud-spanner/latest/CommitTimestamp)\n- [1.103.0](/php/docs/reference/cloud-spanner/1.103.0/CommitTimestamp)\n- [1.102.0](/php/docs/reference/cloud-spanner/1.102.0/CommitTimestamp)\n- [1.101.0](/php/docs/reference/cloud-spanner/1.101.0/CommitTimestamp)\n- [1.100.0](/php/docs/reference/cloud-spanner/1.100.0/CommitTimestamp)\n- [1.98.0](/php/docs/reference/cloud-spanner/1.98.0/CommitTimestamp)\n- [1.97.0](/php/docs/reference/cloud-spanner/1.97.0/CommitTimestamp)\n- [1.96.0](/php/docs/reference/cloud-spanner/1.96.0/CommitTimestamp)\n- [1.95.0](/php/docs/reference/cloud-spanner/1.95.0/CommitTimestamp)\n- [1.94.0](/php/docs/reference/cloud-spanner/1.94.0/CommitTimestamp)\n- [1.93.1](/php/docs/reference/cloud-spanner/1.93.1/CommitTimestamp)\n- [1.92.1](/php/docs/reference/cloud-spanner/1.92.1/CommitTimestamp)\n- [1.91.0](/php/docs/reference/cloud-spanner/1.91.0/CommitTimestamp)\n- [1.90.0](/php/docs/reference/cloud-spanner/1.90.0/CommitTimestamp)\n- [1.89.0](/php/docs/reference/cloud-spanner/1.89.0/CommitTimestamp)\n- [1.88.0](/php/docs/reference/cloud-spanner/1.88.0/CommitTimestamp)\n- [1.87.0](/php/docs/reference/cloud-spanner/1.87.0/CommitTimestamp)\n- [1.86.0](/php/docs/reference/cloud-spanner/1.86.0/CommitTimestamp)\n- [1.85.0](/php/docs/reference/cloud-spanner/1.85.0/CommitTimestamp)\n- [1.84.0](/php/docs/reference/cloud-spanner/1.84.0/CommitTimestamp)\n- [1.83.0](/php/docs/reference/cloud-spanner/1.83.0/CommitTimestamp)\n- [1.82.0](/php/docs/reference/cloud-spanner/1.82.0/CommitTimestamp)\n- [1.81.0](/php/docs/reference/cloud-spanner/1.81.0/CommitTimestamp)\n- [1.80.0](/php/docs/reference/cloud-spanner/1.80.0/CommitTimestamp)\n- [1.79.0](/php/docs/reference/cloud-spanner/1.79.0/CommitTimestamp)\n- [1.78.0](/php/docs/reference/cloud-spanner/1.78.0/CommitTimestamp)\n- [1.77.0](/php/docs/reference/cloud-spanner/1.77.0/CommitTimestamp)\n- [1.76.1](/php/docs/reference/cloud-spanner/1.76.1/CommitTimestamp)\n- [1.68.0](/php/docs/reference/cloud-spanner/1.68.0/CommitTimestamp)\n- [1.67.0](/php/docs/reference/cloud-spanner/1.67.0/CommitTimestamp)\n- [1.66.0](/php/docs/reference/cloud-spanner/1.66.0/CommitTimestamp)\n- [1.65.0](/php/docs/reference/cloud-spanner/1.65.0/CommitTimestamp)\n- [1.64.0](/php/docs/reference/cloud-spanner/1.64.0/CommitTimestamp)\n- [1.63.2](/php/docs/reference/cloud-spanner/1.63.2/CommitTimestamp)\n- [1.62.1](/php/docs/reference/cloud-spanner/1.62.1/CommitTimestamp)\n- [1.61.0](/php/docs/reference/cloud-spanner/1.61.0/CommitTimestamp)\n- [1.60.0](/php/docs/reference/cloud-spanner/1.60.0/CommitTimestamp)\n- [1.59.0](/php/docs/reference/cloud-spanner/1.59.0/CommitTimestamp)\n- [1.58.4](/php/docs/reference/cloud-spanner/1.58.4/CommitTimestamp)\n- [1.57.0](/php/docs/reference/cloud-spanner/1.57.0/CommitTimestamp)\n- [1.56.0](/php/docs/reference/cloud-spanner/1.56.0/CommitTimestamp)\n- [1.55.0](/php/docs/reference/cloud-spanner/1.55.0/CommitTimestamp)\n- [1.54.2](/php/docs/reference/cloud-spanner/1.54.2/CommitTimestamp) \nReference documentation and code samples for the Cloud Spanner Client class CommitTimestamp.\n\nA special value which, when used, will set the field value to the value of\nthe commit timestamp.\n\nCloud Spanner allows users to designate a specific Timestamp column in the\ntable schema to contain commit timestamps. When writing to this column, a\nmanually-created timestamp (in the past) may be supplied, or Cloud Spanner\ncan populate it server-side.\n\nNote that this special value cannot be used unless the column has been\nannotated with support for commit timestamps: \n\n CREATE TABLE myTable (\n id STRING(100) NOT NULL,\n commitTimestamp TIMESTAMP NOT NULL OPTIONS\n (allow_commit_timestamp=true)\n ) PRIMARY KEY(id, commitTimestamp DESC)\n\nExample: \n\n use Google\\Cloud\\Spanner\\SpannerClient;\n\n $spanner = new SpannerClient();\n $database = $spanner-\u003econnect('my-instance', 'my-database');\n\n $database-\u003einsert('myTable', [\n 'id' =\u003e $id,\n 'commitTimestamp' =\u003e $spanner-\u003ecommitTimestamp()\n ]);\n\nNamespace\n---------\n\nGoogle \\\\ Cloud \\\\ Spanner\n\nMethods\n-------\n\n### type\n\n### get\n\n### formatAsString\n\n### __toString\n\nConstants\n---------\n\n### SPECIAL_VALUE\n\n Value: 'spanner.commit_timestamp()'"]]