---
title: Date.FormatStyle.Symbol.CyclicYear
framework: foundation
role: symbol
role_heading: Structure
path: foundation/date/formatstyle/symbol/cyclicyear
---

# Date.FormatStyle.Symbol.CyclicYear

A type that specifies a format for a cyclic year in a date format style.

## Declaration

```swift
struct CyclicYear
```

## Overview

Overview Calendars such as the Chinese lunar calendar and Hindu calendars use 60-year cycles of year names. If the calendar doesn’t provide cyclic year-name data, or if the year value to format is out of the range of years for which the system provides cyclic name data, then the formatting is numeric, as in Date.FormatStyle.Symbol.Year. The Date.FormatStyle.Symbol.CyclicYear type includes static factory variables that create custom Date.FormatStyle.Symbol.CyclicYear objects:  |   |   |   |  If no format is specified as a parameter, the abbreviated static variable is the default format. For more information about formatting dates, see Date.FormatStyle.

## Topics

### Modifying a Cyclic Year

- [abbreviated](foundation/date/formatstyle/symbol/cyclicyear/abbreviated.md)
- [narrow](foundation/date/formatstyle/symbol/cyclicyear/narrow.md)
- [wide](foundation/date/formatstyle/symbol/cyclicyear/wide.md)

### Comparing Cyclic Years

- [==(_:_:)](foundation/date/==(_:_:).md)

### Type Properties

- [omitted](foundation/date/formatstyle/symbol/cyclicyear/omitted.md)

## Relationships

### Conforms To

- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Modifying Date Style Format Symbols

- [Date.FormatStyle.Symbol.Day](foundation/date/formatstyle/symbol/day.md)
- [Date.FormatStyle.Symbol.DayOfYear](foundation/date/formatstyle/symbol/dayofyear.md)
- [Date.FormatStyle.Symbol.DayPeriod](foundation/date/formatstyle/symbol/dayperiod.md)
- [Date.FormatStyle.Symbol.Era](foundation/date/formatstyle/symbol/era.md)
- [Date.FormatStyle.Symbol.Hour](foundation/date/formatstyle/symbol/hour.md)
- [Date.FormatStyle.Symbol.Minute](foundation/date/formatstyle/symbol/minute.md)
- [Date.FormatStyle.Symbol.Month](foundation/date/formatstyle/symbol/month.md)
- [Date.FormatStyle.Symbol.Quarter](foundation/date/formatstyle/symbol/quarter.md)
- [Date.FormatStyle.Symbol.Second](foundation/date/formatstyle/symbol/second.md)
- [Date.FormatStyle.Symbol.SecondFraction](foundation/date/formatstyle/symbol/secondfraction.md)
- [Date.FormatStyle.Symbol.StandaloneMonth](foundation/date/formatstyle/symbol/standalonemonth.md)
- [Date.FormatStyle.Symbol.StandaloneQuarter](foundation/date/formatstyle/symbol/standalonequarter.md)
- [Date.FormatStyle.Symbol.StandaloneWeekday](foundation/date/formatstyle/symbol/standaloneweekday.md)
- [Date.FormatStyle.Symbol.TimeZone](foundation/date/formatstyle/symbol/timezone.md)
- [Date.FormatStyle.Symbol.VerbatimHour](foundation/date/formatstyle/symbol/verbatimhour.md)