<!--
{
  "availability" : [
    "watchOS: 5.0.0 - 27.2.0"
  ],
  "documentType" : "symbol",
  "framework" : "ClockKit",
  "identifier" : "/documentation/ClockKit/CLKTimeIntervalGaugeProvider/init(style:gaugeColors:gaugeColorLocations:start:startFillFraction:end:endFillFraction:)",
  "metadataVersion" : "0.1.0",
  "role" : "Initializer",
  "symbol" : {
    "kind" : "Initializer",
    "modules" : [
      "ClockKit"
    ],
    "preciseIdentifier" : "c:objc(cs)CLKTimeIntervalGaugeProvider(cm)gaugeProviderWithStyle:gaugeColors:gaugeColorLocations:startDate:startFillFraction:endDate:endFillFraction:"
  },
  "title" : "init(style:gaugeColors:gaugeColorLocations:start:startFillFraction:end:endFillFraction:)"
}
-->

# init(style:gaugeColors:gaugeColorLocations:start:startFillFraction:end:endFillFraction:)

Creates a time interval gauge, letting you specify whether the gauge fills or empties as time passes.

```
convenience init(style: CLKGaugeProviderStyle, gaugeColors: [UIColor]?, gaugeColorLocations: [NSNumber]?, start startDate: Date, startFillFraction: Float, end endDate: Date, endFillFraction: Float)
```

## Parameters

`style`

The style defining the gauge’s visual appearance. For a list of valid styles, see [`CLKGaugeProviderStyle`](/documentation/ClockKit/CLKGaugeProviderStyle).

`gaugeColors`

The gauge’s colors. These colors are displayed as a gradient.

`gaugeColorLocations`

The location of each color along the gauge. Locations are values between `0.0` and `1.0`. If `nil`, the colors are evenly spaced along the gauge.

`startDate`

The start time and date.

`startFillFraction`

The starting position for the gague. This is a value between `0.0` and `1.0`.

`endDate`

The end time and date. This value must be later than or equal to the start date.

`endFillFraction`

The end position of the gague. This is a value between `0.0` and `1.0`.

## Return Value

A newly instantiated time interval gauge provider.

## Discussion

The gauge shows the amount of time that has elapsed, based on the current time relative to the specified start and end dates. You can specify whether the gauge counts up or counts down using the `startFillFraction` and `endFillFraction` parameters.

- If the `startFillFraction` is less than the `endFillFraction`, the gauge fills as it counts up from the start time to the end time.
- If the `startFillFraction` is greater than the `endFillFraction`, the gauge empties as it counts down from the start time to the end time.
- On circular gauges, the fill fractions also determine the position of the start and end points along the circle. `0.0` indicates the top of the circle. Values increase as you move around the circle clockwise, with `1.0` back at the top again.
- On corner gauges, you should always use the `0.0` and `1.0` as your fractional values, to ensure that you’re utilizing the whole gauge.

If you provide both colors and locations, then the `gaugeColors` and `gaugeColorLocations` arrays must be the same length.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)