feat(applicationautoscaling): timezone property for scheduled actions

packages/@aws-cdk/aws-applicationautoscaling/lib/scalable-target.ts

@@ -161,6 +161,7 @@ export class ScalableTarget extends Resource implements IScalableTarget {
         maxCapacity: action.maxCapacity,
         minCapacity: action.minCapacity,
       },
+      timezone: action.timezone,
     });
   }
 
@@ -225,6 +226,14 @@ export interface ScalingSchedule {
    * @default No new maximum capacity
    */
   readonly maxCapacity?: number;
+
+  /**
+   * The time zone used when referring to the date and time of a scheduled action,
+   * when the scheduled action uses an at or cron expression.
+   *
+   * @default - No specific time zone.
+   */
+  readonly timezone?: string;
 }
 
 /**

packages/@aws-cdk/aws-applicationautoscaling/test/scalable-target.test.ts

@@ -79,6 +79,35 @@ describe('scalable target', () => {
     });
   });
 
+  test('add scheduled scaling with timezone support', () => {
+    // GIVEN
+    const stack = new cdk.Stack();
+    const target = createScalableTarget(stack);
+
+    // WHEN
+    target.scaleOnSchedule('ScaleUp', {
+      schedule: appscaling.Schedule.rate(cdk.Duration.minutes(1)),
+      maxCapacity: 50,
+      minCapacity: 1,
+      timezone: 'America/New_York',
+    });
+
+    // THEN
+    Template.fromStack(stack).hasResourceProperties('AWS::ApplicationAutoScaling::ScalableTarget', {
+      ScheduledActions: [
+        {
+          ScalableTargetAction: {
+            MaxCapacity: 50,
+            MinCapacity: 1,
+          },
+          Schedule: 'rate(1 minute)',
+          ScheduledActionName: 'ScaleUp',
+          Timezone: 'America/New_York',
+        },
+      ],
+    });
+  });
+
   test('scheduled scaling shows warning when minute is not defined in cron', () => {
     // GIVEN
     const stack = new cdk.Stack();

packages/@aws-cdk/aws-dynamodb/README.md

@@ -87,6 +87,7 @@ times of the day:
 Auto-scaling is only relevant for tables with the billing mode, PROVISIONED.
 
 [Example of configuring autoscaling](test/integ.autoscaling.lit.ts)
+[Example of configuring the table as a scalable target](test/integ.dynamodb.scalable-target.ts)
 
 Further reading:
 https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/AutoScaling.html

packages/@aws-cdk/aws-dynamodb/test/integ.dynamodb.scalable-target.ts

@@ -0,0 +1,42 @@
+import * as appscaling from '@aws-cdk/aws-applicationautoscaling';
+import { App, Stack } from '@aws-cdk/core';
+import * as integ from '@aws-cdk/integ-tests';
+import { AttributeType, Table } from '../lib';
+
+const app = new App();
+const env = {
+  region: process.env.CDK_DEFAULT_REGION,
+  account: process.env.CDK_DEFAULT_ACCOUNT,
+};
+const stack = new Stack(app, 'demo-stack', { env });
+
+const table = new Table(stack, 'Table', {
+  partitionKey: {
+    name: 'id',
+    type: AttributeType.STRING,
+  },
+});
+
+const target = new appscaling.ScalableTarget(stack, 'Target', {
+  serviceNamespace: appscaling.ServiceNamespace.DYNAMODB,
+  scalableDimension: 'dynamodb:table:ReadCapacityUnits',
+  resourceId: `table/${table.tableName}`,
+  minCapacity: 1,
+  maxCapacity: 20,
+});
+
+target.scaleOnSchedule('scheduledScaling', {
+  timezone: 'America/New_York',
+  schedule: appscaling.Schedule.cron({
+    hour: '0',
+    minute: '10',
+  }),
+  minCapacity: 20,
+  maxCapacity: 100,
+});
+
+new integ.IntegTest(app, 'IntegTest', {
+  testCases: [stack],
+});
+
+app.synth();