# iOS-TimesSquare

**Repository Path**: mirrors/iOS-TimesSquare

## Basic Information

- **Project Name**: iOS-TimesSquare
- **Description**: TimesSquare 是一个用于 iPhone 和 iPad 上显示日历的控件
- **Primary Language**: Objective-C
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://www.oschina.net/p/ios-timessquare
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-11-23
- **Last Updated**: 2025-10-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TimesSquare

[![CI Status](https://travis-ci.org/square/objc-TimesSquare.svg?branch=master)](https://travis-ci.org/square/objc-TimesSquare)
[![Version](https://img.shields.io/cocoapods/v/TimesSquare.svg)](http://cocoadocs.org/docsets/TimesSquare)
[![License](https://img.shields.io/cocoapods/l/TimesSquare.svg)](http://cocoadocs.org/docsets/TimesSquare)
[![Platform](https://img.shields.io/cocoapods/p/TimesSquare.svg)](http://cocoadocs.org/docsets/TimesSquare)

TimesSquare is a library to display a calendar in a view in your iPhone or iPad app. We wrote it after searching high and low for a better way and finding none.

## Usage
![Gregorian Calendar](https://github.com/square/objc-TimesSquare/raw/master/Documentation/gregorian.png)

Easy: create an instance of `TSQCalendarView`. Set its `firstDate` and `lastDate` properties to give yourself a range of dates.

## Calendars
![Hebrew Calendar](https://github.com/square/objc-TimesSquare/raw/master/Documentation/hebrew.png)

While we fully expect you'll use it to display a Gregorian calendar most of the time, TimesSquare is just as happy displaying any of the calendars `NSCalendar` supports. The included test app shows you how to do this.

## Further documentation

If you install [appledoc](http://gentlebytes.com/appledoc/) ("`brew info homebrew/versions/appledoc22`", "`ln -s /usr/local/Cellar/appledoc22/2.2.1/bin/appledoc /usr/local/bin/appledoc`") you can build the "TimesSquare Documentation" target in Xcode and see (and search!) the full API in your documentation window.

## Contributing

We're glad you're interested in TimesSquare, and we'd love to see where you take it.

Any contributors to the master TimesSquare repository must sign the [Individual Contributor License Agreement (CLA)](https://spreadsheets.google.com/spreadsheet/viewform?formkey=dDViT2xzUHAwRkI3X3k5Z0lQM091OGc6MQ&ndplr=1). It's a short form that covers our bases and makes sure you're eligible to contribute.

When you have a change you'd like to see in the master repository, [send a pull request](https://github.com/square/objc-TimesSquare/pulls). Before we merge your request, we'll make sure you're in the list of people who have signed a CLA.

Thanks, and happy date picking!