Django model字段類型清單

Django 經過 models 實現數據庫的建立、修改、刪除等操做，本文爲模型中通常經常使用的類型的清單，便於查詢和使用：

AutoField：一個自動遞增的整型字段，添加記錄時它會自動增加。你一般不須要直接使用這個字段；若是你不指定主鍵的話，系統會自動添加一個主鍵字段到你的model。(參閱自動主鍵字段)

BooleanField：布爾字段,管理工具裏會自動將其描述爲checkbox。

CharField：字符串字段，單行輸入，用於較短的字符串，如要保存大量文本, 使用 TextField，CharField有一個必填參數：

CharField.max_length：字符的最大長度，django會根據這個參數在數據庫層和校驗層限制該字段所容許的最大字符數。

TextField：一個容量很大的文本字段， admin 管理界面用 <textarea>多行編輯框表示該字段數據。

CommaSeparatedIntegerField：用於存放逗號分隔的整數值。相似 CharField，必須maxlength 參數。

DateField：日期字段，admin 用一個文本框 <input type=」text」> 來表示該字段數據(附帶一個 JavaScript 日曆和一個」Today」快捷按鍵。有下列額外的可選參數：

auto_now：當對象被保存時,自動將該字段的值設置爲當前時間.一般用於表示 「last-modified」 時間戳；
auto_now_add：當對象首次被建立時,自動將該字段的值設置爲當前時間.一般用於表示對象建立時間。

DateTimeField：相似 DateField 支持一樣的附加選項。

EmailField：一個帶有檢查 Email 合法性的 CharField，不接受 maxlength 參數。

FileField：一個文件上傳字段。 要求一個必須有的參數： upload_to， 一個用於保存上載文件的本地文件系統路徑。 這個路徑必須包含 strftime formatting， 該格式將被上載文件的 date/time 替換(so that uploaded files don’t fill up the given directory)。在一個 model 中使用 FileField 或 ImageField 須要如下步驟：在你的 settings 文件中， 定義一個完整路徑給 MEDIA_ROOT 以便讓 Django在此處保存上傳文件。 (出於性能考慮，這些文件並不保存到數據庫。) 定義 MEDIA_URL 做爲該目錄的公共 URL。 要確保該目錄對 WEB 服務器用戶賬號是可寫的。在你的 model 中添加 FileField 或 ImageField， 並確保定義了 upload_to 選項，以告訴 Django 使用 MEDIA_ROOT 的哪一個子目錄保存上傳文件。你的數據庫中要保存的只是文件的路徑(相對於 MEDIA_ROOT)。 出於習慣你必定很想使用 Django 提供的 get_<fieldname>_url 函數。舉例來講，若是你的 ImageField 叫做 mug_shot， 你就能夠在模板中以 {{ object。get_mug_shot_url }} 這樣的方式獲得圖像的絕對路徑。

FilePathField：選擇指定目錄按限制規則選擇文件，有三個參數可選， 其中」path」必需的，這三個參數能夠同時使用， 參數描述：

path：必需參數，一個目錄的絕對文件系統路徑。 FilePathField 據此獲得可選項目。 Example： 「/home/p_w_picpaths」；
match：可選參數， 一個正則表達式， 做爲一個字符串， FilePathField 將使用它過濾文件名。 注意這個正則表達式只會應用到 base filename 而不是路徑全名。 Example： 「foo。*\。txt^」， 將匹配文件 foo23.txt 卻不匹配 bar.txt 或 foo23.gif；
recursive：可選參數， 是否包括 path 下所有子目錄，True 或 False，默認值爲 False。

match 僅應用於 base filename， 而不是路徑全名。 如：FilePathField(path=」/home/p_w_picpaths」， match=」foo.*」， recursive=True)…會匹配 /home/p_w_picpaths/foo.gif 而不匹配 /home/p_w_picpaths/foo/bar.gif

FloatField：浮點型字段。 必須提供兩個 參數， 參數描述：

max_digits：總位數(不包括小數點和符號)
decimal_places：小數位數。如：要保存最大值爲 999 (小數點後保存2位)，你要這樣定義字段：models.FloatField(…，max_digits=5， decimal_places=2)，要保存最大值一百萬(小數點後保存10位)的話，你要這樣定義：models.FloatField(…，max_digits=19， decimal_places=10)

ImageField：相似 FileField， 不過要校驗上傳對象是不是一個合法圖片。它有兩個可選參數：height_field 和 width_field，若是提供這兩個參數，則圖片將按提供的高度和寬度規格保存。 該字段要求 Python Imaging 庫。

IntegerField：用於保存一個整數。

IPAddressField：一個字符串形式的 IP 地址， (如 「202.1241.30″)。

NullBooleanField：相似 BooleanField， 不過容許 NULL 做爲其中一個選項。 推薦使用這個字段而不要用 BooleanField 加 null=True 選項。 admin 用一個選擇框 <select> (三個可選擇的值： 「Unknown」， 「Yes」 和 「No」 ) 來表示這種字段數據。

PhoneNumberField：一個帶有合法美國風格電話號碼校驗的 CharField(格式：XXX-XXX-XXXX)。

PositiveIntegerField：相似 IntegerField， 但取值範圍爲非負整數（這個字段應該是容許0值的…能夠理解爲無符號整數）

PositiveSmallIntegerField：

正小整型字段，相似 PositiveIntegerField， 取值範圍較小(數據庫相關)SlugField「Slug」 是一個報紙術語。 slug 是某個東西的小小標記(短籤)， 只包含字母，數字，下劃線和連字符。它們一般用於URLs。 若你使用 Django 開發版本，你能夠指定 maxlength。 若 maxlength 未指定， Django 會使用默認長度： 50，它接受一個額外的參數：

prepopulate_from: 來源於slug的自動預置列表

SlugField：是一個報紙術語. slug 是某個東西的小小標記(短籤), 只包含字母,數字,下劃線和連字符.它們一般用於URLs。

SmallIntegerField：相似 IntegerField， 不過只容許某個取值範圍內的整數。(依賴數據庫)

TimeField：時間字段，相似於 DateField 和 DateTimeField。

URLField：用於保存 URL。 若 verify_exists 參數爲 True (默認)， 給定的 URL 會預先檢查是否存在(即URL是否被有效裝入且沒有返回404響應)。

USStateField：美國州名縮寫，由兩個字母組成（天朝人民無視）。

XMLField：XML字符字段，校驗值是否爲合法XML的 TextField，必須提供參數：

schema_path：校驗文本的 RelaxNG schema 的文件系統路徑。

附：Field 選項

• 
  

  • null ：缺省設置爲false.一般不將其用於字符型字段上，好比CharField,TextField上.字符型字段若是沒有值會返回空字符串。

  • blank：該字段是否能夠爲空。若是爲假，則必須有值

  • choices：一個用來選擇值的2維元組。第一個值是實際存儲的值，第二個用來方便進行選擇。如SEX_CHOICES= ((‘F’,'Female’),(‘M’,'Male’),)

  • core：db_column，db_index 若是爲真將爲此字段建立索引

  • default：設定缺省值

  • editable：若是爲假，admin模式下將不能改寫。缺省爲真

  • help_text：admin模式下幫助文檔

  • primary_key：設置主鍵，若是沒有設置django建立表時會自動加上：

1	id = meta.AutoField('ID', primary_key=True)

2	primary_key=True implies blank=False, null=False and unique=True. Only one primary key is allowed on an object.

• radio_admin：用於admin模式下將select轉換爲radio顯示。只用於ForeignKey或者設置了choices

• unique：數據惟一

• unique_for_date：日期惟一，以下例中系統將不容許title和pub_date兩個都相同的數據重複出現

• title = meta.CharField(maxlength=30,unique_for_date=’pub_date’)

• unique_for_month / unique_for_year：用法同上

• validator_list：有效性檢查。非有效產生 django.core.validators.ValidationError 錯誤