feat(kinesisfirehose): support custom time zone settings for S3 destination

packages/@aws-cdk-testing/framework-integ/test/aws-kinesisfirehose/test/integ.s3-bucket.lit.js.snapshot/aws-cdk-firehose-delivery-stream-s3-all-properties.template.json

@@ -579,6 +579,7 @@
       }
      },
      "CompressionFormat": "GZIP",
+     "CustomTimeZone": "Asia/Tokyo",
      "EncryptionConfiguration": {
       "KMSEncryptionConfig": {
        "AWSKMSKeyARN": {

packages/@aws-cdk-testing/framework-integ/test/aws-kinesisfirehose/test/integ.s3-bucket.lit.ts

@@ -56,6 +56,7 @@ const deliveryStream = new firehose.DeliveryStream(stack, 'DeliveryStream', {
     dataOutputPrefix: 'regularPrefix',
     errorOutputPrefix: 'errorPrefix',
     fileExtension: '.log.gz',
+    timeZone: cdk.TimeZone.ASIA_TOKYO,
     bufferingInterval: cdk.Duration.seconds(60),
     bufferingSize: cdk.Size.mebibytes(1),
     encryptionKey: key,

packages/aws-cdk-lib/aws-kinesisfirehose/README.md

@@ -102,10 +102,13 @@ will be used for files successfully delivered to S3. `errorOutputPrefix` will be
 failed records before writing them to S3.
 
 ```ts
+import { TimeZone } from 'aws-cdk-lib';
 declare const bucket: s3.Bucket;
 const s3Destination = new firehose.S3Bucket(bucket, {
   dataOutputPrefix: 'myFirehose/DeliveredYear=!{timestamp:yyyy}/anyMonth/rand=!{firehose:random-string}',
   errorOutputPrefix: 'myFirehoseFailures/!{firehose:error-output-type}/!{timestamp:yyyy}/anyMonth/!{timestamp:dd}',
+  // The time zone of timestamps (default UTC)
+  timeZone: TimeZone.ASIA_TOKYO,
 });
 ```
 

packages/aws-cdk-lib/aws-kinesisfirehose/lib/s3-bucket.ts

@@ -4,7 +4,7 @@ import { DestinationBindOptions, DestinationConfig, IDestination } from './desti
 import * as iam from '../../aws-iam';
 import * as s3 from '../../aws-s3';
 import { createBackupConfig, createBufferingHints, createEncryptionConfig, createLoggingOptions, createProcessingConfig } from './private/helpers';
-import { Token, UnscopedValidationError, ValidationError } from '../../core';
+import { TimeZone, Token, UnscopedValidationError, ValidationError } from '../../core';
 
 /**
  * Props for defining an S3 destination of an Amazon Data Firehose delivery stream.
@@ -20,6 +20,15 @@ export interface S3BucketProps extends CommonDestinationS3Props, CommonDestinati
    * @default - The default file extension appended by Data Format Conversion or S3 compression features
    */
   readonly fileExtension?: string;
+
+  /**
+   * The time zone you prefer.
+   *
+   * @see https://docs.aws.amazon.com/firehose/latest/dev/s3-prefixes.html#timestamp-namespace
+   *
+   * @default - UTC
+   */
+  readonly timeZone?: TimeZone;
 }
 
 /**
@@ -71,6 +80,7 @@ export class S3Bucket implements IDestination {
         errorOutputPrefix: this.props.errorOutputPrefix,
         prefix: this.props.dataOutputPrefix,
         fileExtension: this.props.fileExtension,
+        customTimeZone: this.props.timeZone?.timezoneName,
       },
       dependables: [bucketGrant, ...(loggingDependables ?? []), ...(backupDependables ?? [])],
     };

packages/aws-cdk-lib/aws-kinesisfirehose/test/s3-bucket.test.ts

@@ -658,4 +658,20 @@ describe('S3 destination', () => {
       }).toThrow("fileExtension can contain allowed characters: 0-9a-z!-_.*'()");
     });
   });
+
+  it('sets customTimeZone', () => {
+    const destination = new firehose.S3Bucket(bucket, {
+      role: destinationRole,
+      timeZone: cdk.TimeZone.ASIA_TOKYO,
+    });
+    new firehose.DeliveryStream(stack, 'DeliveryStream', {
+      destination: destination,
+    });
+
+    Template.fromStack(stack).hasResourceProperties('AWS::KinesisFirehose::DeliveryStream', {
+      ExtendedS3DestinationConfiguration: {
+        CustomTimeZone: 'Asia/Tokyo',
+      },
+    });
+  });
 });