> ## Documentation Index
> Fetch the complete documentation index at: https://docs.checkable.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 시간 제한 기능 가이드

> 챌린지 인증 가능 시간을 설정하여 더 효과적인 챌린지를 운영해보세요

# 시간 제한 기능 가이드

> Premium 전용. 챌린지 시작 전(Pending)에서만 설정/수정할 수 있습니다.

## TL;DR

* 하루 중 정해진 시간대에만 인증 가능: `startTime` \~ `endTime`
* 입력은 HH:MM, 저장 시 시작은 :00, 종료는 :59가 자동 적용됩니다
* 시작 전 제출은 무효, 종료 이후 제출은 무효(늦제출 허용 시 ⏳로 인정될 수 있음)
* 더 늦게 제출을 일부 허용하려면 늦제출 허용 기능을 함께 사용하세요

> Premium 전용. 챌린지 시작 전(Pending)에서만 설정/수정할 수 있습니다.

시간 제한 기능을 사용하면 챌린지 참여자들이 특정 시간대에만 인증을 제출할 수 있도록 제한할 수 있습니다. 이를 통해 더 구체적이고 효과적인 챌린지를 운영할 수 있습니다.

## 🕐 시간 제한이란?

기본적으로 챌린지는 하루 24시간 동안 언제든지 인증을 제출할 수 있습니다. 하지만 시간 제한 기능을 사용하면 특정 시간대에만 인증이 가능하도록 설정할 수 있습니다.

### 기본 설정 vs 시간 제한 설정

| 구분    | 기본 설정                 | 시간 제한 설정         |
| ----- | --------------------- | ---------------- |
| 인증 시간 | 24시간 (00:00 \~ 23:59) | 설정한 시간대만         |
| 예시    | 언제든지 인증 가능            | 오전 6시\~9시만 인증 가능 |
| 활용도   | 일반적인 챌린지              | 특정 목적의 챌린지       |

## 🎯 활용 사례

### 1. 미라클 모닝 챌린지

* **시간 설정**: 06:00 \~ 09:00
* **목적**: 아침 일찍 일어나서 활동하는 습관 형성
* **효과**: 참여자들이 정해진 시간에만 인증하므로 더 체계적인 생활 가능

### 2. 점심 운동 챌린지

* **시간 설정**: 12:00 \~ 13:00
* **목적**: 점심 시간을 활용한 짧은 운동
* **효과**: 업무 중간에 운동 습관을 만들 수 있음

### 3. 저녁 독서 챌린지

* **시간 설정**: 20:00 \~ 22:00
* **목적**: 하루를 마무리하는 독서 시간
* **효과**: 정해진 시간에 독서하는 습관 형성

### 4. 새벽 기도 챌린지

* **시간 설정**: 05:00 \~ 07:00
* **목적**: 새벽 기도 시간 확보
* **효과**: 규칙적인 기도 생활 가능

## ⚙️ 설정 방법

### 1단계: 챌린지 생성/수정 페이지 접속

1. 워크스페이스에서 챌린지 생성 또는 수정 페이지로 이동
2. "인증 설정" 섹션을 찾습니다

### 2단계: 시작 시간 설정

* **시작 시간** 필드에 인증이 시작되는 시간을 입력
* **형식**: HH:MM (예: 06:00, 저장 시 :00이 자동 추가)
* **예시**: 오전 6시부터 시작하려면 `06:00` 입력

### 3단계: 종료 시간 설정

* **종료 시간** 필드에 인증이 끝나는 시간을 입력
* **형식**: HH:MM (예: 09:00, 저장 시 :59가 자동 추가)
* **예시**: 오전 9시까지라면 `09:00` 입력

### 4단계: 설정 확인

* 시작 시간이 종료 시간보다 빠른지 확인
* 설정한 시간이 올바른지 다시 한번 확인

## 🔍 동작 방식

### 인증 메시지 생성

* 설정한 시간 범위 내에서만 인증용 메시지가 생성됩니다
* 시간 외에는 인증 메시지가 생성되지 않습니다

### 인증 제한

* 설정한 시간 외에는 인증을 제출할 수 없습니다
* 시간이 지나면 해당 날짜의 인증은 불가능합니다

### 예시 타임라인

```
설정: 06:00 ~ 09:00

05:59  → ❌ 무효(시작 전)
06:00  → ✅ 유효(시작과 동일)
08:59:59 → ✅ 유효(종료 직전)
09:00:00 → ❌ 무효(종료 직후, 늦제출 허용 시 ⏳ 가능)
```

### 정확한 시간 체크

* 분 단위까지 정확하게 시간을 체크합니다
* 종료 시간에는 자동으로 59초가 추가되어 처리됩니다

### 경계값(엣지 케이스)

* 시작 시각과 정확히 같은 시각 제출: ✅ 허용됩니다
* 종료 시각과 정확히 같은 분의 59초까지: ✅ 허용됩니다(종료는 :59가 자동 부여)
* 종료 직후 제출: ❌ 무효. 단, 늦제출 허용(cutoffMin)이 설정되어 있다면 ⏳로 인정될 수 있습니다

## ⚠️ 주의사항

### 변경 불가

* 챌린지가 시작된 후에는 시간 설정을 변경할 수 없습니다
* 신중하게 시간을 설정해주세요

### 기능 연동

* 시간 제한은 “정시(✅)”의 유효 구간을 정의합니다
* “늦제출(⏳)”을 허용하려면 [늦제출 허용 기능](/features/late-submission)을 활성화하세요

### 시간 형식

* 반드시 HH:MM 형식으로 입력해야 합니다
* 예: 06:00, 18:30, 23:59

### 시간 순서

* 시작 시간은 반드시 종료 시간보다 빨라야 합니다
* 잘못된 시간 설정 시 오류 메시지가 표시됩니다

### 24시간 제한

* 하루를 넘어가는 시간 설정은 불가능합니다
* 예: 오전 6시 \~ 다음날 오전 6시는 설정 불가

## 💡 활용 팁

### 1. 현실적인 시간 설정

* 참여자들이 실제로 가능한 시간대를 설정하세요
* 너무 짧거나 긴 시간은 참여율에 영향을 줄 수 있습니다

### 2. 충분한 시간 여유

* 너무 짧은 시간은 참여자들에게 부담을 줄 수 있습니다
* 최소 1시간 이상의 여유를 두는 것을 권장합니다

### 3. 명확한 안내

* 시간 제한에 대해 참여자들에게 미리 안내하세요
* 인증 시간을 명확히 공지하여 혼란을 방지하세요

### 4. 계절 고려

* 계절에 따라 일조량이 달라지므로 시간을 조정하세요
* 겨울에는 늦게, 여름에는 일찍 시작하는 것을 고려하세요

## 🚀 효과적인 챌린지 운영

### 시간 제한의 장점

1. **규칙적인 생활**: 정해진 시간에 활동하는 습관 형성
2. **동기 부여**: 시간 제한으로 인한 긴장감과 동기 부여
3. **효율성**: 특정 목적에 맞는 구체적인 챌린지 운영
4. **성취감**: 시간 제한을 지켜 인증할 때의 성취감

### 운영 전략

1. **적절한 시간대 선택**: 참여자들의 생활 패턴을 고려
2. **명확한 목표 설정**: 시간 제한의 목적을 명확히 안내
3. **지속적인 모니터링**: 참여율과 피드백을 주기적으로 확인
4. **유연한 조정**: 필요시 다음 챌린지에서 시간 조정

## 📞 도움말

### 자주 묻는 질문

**Q: 시간 제한을 설정했는데 인증이 안 돼요**
A: 설정한 시간 범위 내에서만 인증이 가능합니다. 현재 시간을 확인해보세요.

**Q: 시간 설정을 변경하고 싶어요**
A: 챌린지가 시작된 후에는 시간 설정을 변경할 수 없습니다. 새로운 챌린지를 만들어주세요.

**Q: 시간 형식이 맞지 않는다고 나와요**
A: HH:MM 형식으로 입력해주세요. 예: 06:00, 18:30

### 지원

* **이메일**: [help@checkable.app](mailto:help@checkable.app)
* **Discord 커뮤니티**: [체커블 Discord](https://discord.gg/x8Qtt2aasJ)

### 다음 단계

* [챌린지 옵션 가이드](/features/challenge-options)
* [늦제출 허용 기능](/features/late-submission)
* [챌린지 관리 상세 가이드](/features/challenge-management)
