📍field type

from django.db import models

✏️ String Field

CharField

class CharField(max_length=None, **options)

# ex
name = models.CharField(max_length=20)

필수 인자

• max_length : 필드의 최대 길이

TextField

텍스트 양이 많은 경우

class TextField(**options)

# ex
description= models.TextField()

✏️Numeric Field

IntegerField

4 Bytes까지 정수 값

class IntegerField(**options)

# ex
order_id = models.IntegerField(default=0)

DecimalField

고정 소수점 이하의 십진수

class DecimalField(max_digits=None, decimal_places=None, **options)

# ex
price = models.DecimalField(max_digits=11, decimal_places=2)

필수 인자

• max_digits : 숫자에 허용되는 최대 자릿수. 이 수는 decimal_places보다 크거나 같아야한다.
• decimal_places : 숫자와 함께 저장하는 소수 자릿수
  소수점 이하 3 자리수의 숫자를 999개까지 저장하려면 max_digits=5 및 decimal_places=3 사용

FloatField

class FloatField(**options)

BigIntegerField

8 Bytes까지 정수 값

class BigIntegerField(**options)

SmallIntegerField

2 Bytes까지 정수 값

class SmallIntegerField(**options)

# ex
quantity = models.SmallIntegerField()

PositiveIntegerField

class PositiveIntegerField(**options)

PositiveBigIntegerField

class PositiveBigIntegerField(**options)

PositiveSmallIntegerField

class PositiveSmallIntegerField(**options)

AutoField

자동으로 증가하는 정수 필드

class AutoField(**options)

BigAutoField

1 to 9223372036854775807 까지 1씩 자동 증가

class BigAutoField(**options)

SmallAutoField

1 to 32767까지 1씩 자동 증가

class SmallAutoField(**options)

BooleanField

true/false 필드
default가 정해있지 않은 경우 default값은 None

class BooleanField(**options)

# ex
is_exit = models.BooleanField(default=False)

✏️DateTime

DateField

class DateField(auto_now=False, auto_now_add=False, **options)

# ex
updated_at = models.DateField(auto_now=True)
created_at = models.DateField(auto_now_add=)

auto_now
객체가 저장될 때 현재 날짜를 저장
Model.save()가 될 때 자동으로 업데이트 되고, QuerySet.update()같은 경우에는 업데이트 되지 않는다.

auto_now_add
객체가 처음 저장될 때 현재 날짜를 저장

auto_now_add, auto_now, default 옵션은 상호 배타적이라, 이러한 옵션을 조합하면 오류가 발생한다.

DateTimeField

DateField + 시간가지 저장

class DateTimeField(auto_now=False, auto_now_add=False, **options)

# ex
created_at = models.DateTimeField(auto_now_add=True)
updated_at = models.DateTimeField(auto_now=True)

EmailField

class EmailField(max_length=254, **options)

EmailValidator를 사용하여 유효한 메일주소인지 확인할 수 있다.

BinaryField

바이너리 데이터를 저장하는 데 사용되는 특수 필드
바이트만 허용
데이터는 저장시 serialize된다.
바이너리 데이터를 저장하므로이 필드는 필터에서 사용할 수 없다.

class BinaryField(max_length=None, **options)

# ex
my_binary_data = models.BinaryField()

DurationField

기간을 저장하기위한 필드

class DurationField(**options)

FileField

class FileField(upload_to=None, max_length=100, **options)

파일 업로드 필드
primary_key 매개변수는 지원 ❌

FilePathField

파일시스템에서 특정한 디렉토리에 파일 이름으로 제한한다.
세가지 특별인자가 있고 첫번째 인자는 필수이다.

class FilePathField(path='', match=None, recursive=False, allow_files=True, allow_folders=False, max_length=100, **options)

필수 인자path
FilePathField가 선택해야하는 디렉토리를 위한 절대 경로
ex) "home/imgs"
match
파일이름을 필터링할 때 사용할 문자열로 된 정규표현식
정규표현식은 전체 경로가 아닌 기본 파일이름에 적용
recursive
True/False (default = False)
path의 모든 서브 디렉토리가 포함되어야하는지 여부
allow_files
True/False (default = True)
지정된 위치에 파일을 포함할지 여부
allow_files, allow_folders 둘 중 하나는 True여야 한다.
allow_folders
True/False (default = True)
지정된 위치에 폴더를 포함할지 여부

ImageField

class ImageField(upload_to=None, height_field=None, width_field=None, max_length=100, **options)

# ex
photo = models.ImageField(blank=True)

profile_pic = models.ImageField(upload_to="jimin/profile_pic")
# 저장경로 : `ROOT/jimin/profile_pic/xxxx.jpg` 경로에 저장
# DB필드 : `URL/jimin/profile_pic/xxxx.jpg` 문자열 저장

photo = models.ImageField(blank=True, upload_to="blog/%Y/%m/%d")
# 저장경로 : `ROOT/jimin/2022/01/05/xxxx.jpg` 경로에 저장
# DB필드 : `URL/jimin/2022/01/05/xxxx.jpg` 문자열 저장

이미지 저장을 지원하는 모델 필드 (FileField 상속)

GenericIPAddressField

문자열 형식에 IPv4나 IPv6 주소

class GenericIPAddressField(protocol='both', unpack_ipv4=False, **options)

JSONField

JSON 인코딩 데이터를 저장하기위한 필드

class JSONField(encoder=None, decoder=None, **options)

# ex
from django.contrib.postgres.fields import JSONField
from django.db import models

class User(models.Model):
    metadata = JSONField()

class Post(models.Model):
    data = models.JSONField(default='{}')

SlugField

의미있는 URL을 만드는데 사용

???

URLField

URL을 저장하기 위한 CharField이다.
URLValidator를 이용하여 유효성 검사를 할 수 있다.

class URLField(max_length=200, **options)

UUIDField

고유한 식별자를 저장하기 위한 필드

class UUIDField(**options)

ArrayField